Guidance

for users, publishers and sysadmins

Five Stars of Openness

five stars of openness

Introduction

Datasets on data.gov.uk are automatically given an ‘Openness rating’ to give a simple indication of how well the dataset has been made open. The criteria are based on the Five Stars of Openness developed by Tim Berners-Lee.

Often this is a useful driver to improve the data or the metadata. For example releasing data as CSV instead of Excel files gets you to 3 stars instead of 2 (although it is good to provide both if you have them).

Also often this indicates problems with the dataset record - maybe the URL to the data was mistyped, or only goes to a web page about the data.

The ‘Openness rating’ is automatically calculated for a dataset shortly after it is created, edited or harvested. It checks if the licence is open, if the resource links work ok and if the resource formats are open and linked. The resulting score is between 0 and 5 stars. If you hover the mouse pointer over the stars then an explanation of the scoring is provided.

The overall score is the highest of all the resources, so if you have 3 PDFs (score 1) and a CSV (score 3), then the overall score is 3. There is more about the scheme at: http://5stardata.info/

Occasionally the automatic calculation is wrong - it misidentified the format of your file. Do contact us and we can try and improve it.

For overall Openness Score numbers, consult the reports: Openness (Five Stars) report

Mechanics of the system

A dataset is given a score by a background program that is triggered when a dataset is changed (e.g. edited, or harvested) and in our regular sweeps of all datasets (currently every weekend).

Usually the check is done within five seconds, but if the site is busy then it can be deferred for a few hours. Hover over the stars to see the date and time the information is valid for.

Each resource has its own score and the dataset is the highest of its resources.

The code is here: https://github.com/datagovuk/ckanext-qa/tree/2.0

Discussion of the Five Stars system

In discussions of the system we hear fears about a few aspects: