How to submit an ORG Implementation Report

From Government Linked Data (GLD) Working Group Wiki
Jump to: navigation, search

The GLD Working Group would like to know about all efforts to make use of the ORG ontology. If you are involved in such an effort, please send e-mail to public-gld-comments@w3.org (subscribe, archives), and we will summarize it on our Implementations page. This information will help the Working Group (and others) determine when the ORG specification is ready to become a W3C Recommendation.

Reports of implementations such as visualizations or other consumers of ORG data are very welcome, as well as reports of publication of data (public or intranet) which uses the ORG terms.

In your report, please include the following information:

  • Your name, affiliation, and (optionally) the names of other people who helped with the implementation.
  • A short summary of your use of ORG.

If your use includes the publication of data using the ORG ontology then please also tell us:

  • Do you believe your use of the ORG terms conforms with the ORG specification (see below for guidance on how to tell that)?
  • If possible give us access to your data or a representative sample of your data so we can record which ORG terms you are using with minimal effort on your part (see below for ways to do that). If that's not possible, e.g. due to confidentiality, then please send a list of the terms you use.
  • If the data uses some ORG terms via an extension ontology then, if possible, either give us access to the extension ontology or let us know which terms you extend.

Reports of work-in-progress, and incomplete reports, are okay; just send an updated report when you're ready.

Any questions just ask on the list.

Checking conformance

It's not possible to automatically test use of ORG terms since you may use a subset of the terms and there are few formal semantic constraints (the intended usage of terms is largely carried in the prose descriptions of them).

Instead, to help you, we have provided a ORG Validation Suite which gives a set of queries which extract the ORG components of your data. These allow you see what a consumer of your data might see if they tried to query it. If you run these queries on (a representative sample of) your data then you can see if the organizations and associated sub-organizations, sites, membership, posts and change events are found. Of course, if your data doesn't include any information on some of these aspects (e.g. change events) then none will be found, that's fine - the point is to check that the information you do expect to be there is found.

To make it easy for you to do this we have provided an on-line tool which runs these queries, it is available from http://www.w3.org/2011/gld/validator/org.

Note that if your data uses some ORG terms via an extension ontology then you will need to also upload a copy of that ontology in order for the tool to perform the inferences necessary.

There's no requirement to use this tool in order to report on a use ORG, it's simply there as an option.

Providing data access

We'd like to track which terms from ORG people use and understand how it is used in practice. If it is possible to give us access to your data, or a sufficiently representative sample of that would be very helpful. Ways to do that include:

  • if you have uploaded data to the on-line tool http://gld01.w3.org/ then use the "Report" link on that tool to record a copy of the data you uploaded for testing; or
  • send us URLs to a data dump, or a SPARQL endpoint or a Linked Data browsable publication of the data.

If your data is confidential and you would rather simply send us a list of the terms that you use that would be fine too.