Skip to content

Commit 30bcb37

Browse files
BjwebbBjwebb
authored
Merge pull request #136 from OpenDataServices/updated-about-page
Updated about page
2 parents 2ea6b79 + 04265af commit 30bcb37

File tree

1 file changed

+53
-66
lines changed

1 file changed

+53
-66
lines changed

‎prefix_finder/frontend/templates/about.html‎

Lines changed: 53 additions & 66 deletions
Original file line numberDiff line numberDiff line change
@@ -1,103 +1,90 @@
11
{% extends 'base.html' %}
22
{% load i18n %}
3-
43
{% block main %}
54
<main class="main-wrapper" role="main">
65
{% include "sidebar.html" %}
7-
86
<div class="main-content single-content about-page">
97
<div>
108
<h1 class="about-page__header">{% trans "About" %}</h1>
119
</div>
1210

1311
<div class="about-page__half--left">
1412
<h2>What?</h2>
15-
16-
<p>This is a prototype developed as part of the <a href="http://identify-org.net">Identify-org.net</a> joined up organization identifiers project. You can read more about the whole project at <a href="http://identify-org.net">http://identify-org.net</a></p>
17-
<p>We’re building <strong>a list of organization identifier lists</strong> to help join up data on organizations across different datasets.</p>
18-
<p>This is the <strong>alpha</strong> version of a tool to explore that list of lists - developed as a proof-of-concept to test out new research methods to populate the list, and to weight results.</p>
19-
20-
<h2>Is it ready for production use?</h2>
21-
<p>Almost: by default you will only see list that have been reviewed through our research process - so you can start using them. The algorithms for ranking the recommended and suggested lists are still under development, so we're not yet quite ready to point everyone at the site. </p>
13+
<p><strong>org-id.guide is the easiest, quickest and most accurate way to locate organisation identifiers.</strong></p>
14+
<p>We maintain a register of organization lists. Those lists, in turn, provide unique identifiers for companies, charities, government agencies and other kinds of organizations.</p>
15+
<p>We provide a code for each list, so that with the code, plus the identifier, you should be able to uniquely and unambiguously identify any organization in the world.</p>
16+
<p>Many of the lists in our register are official identifier sources (such as a couuntry company register); others lists may be maintained by third-parties. When we can, we link out to websites where you can look up a specific organization, although we also include codes for lists that don't provide a public search service.</p>
17+
<p>We welcome new additions or updates to the register. We don't pre-judge the kinds of lists that should be included - but we do make sure the register includes good meta-data. We us that meta-data to provide a quality score that indicates how accessible and stable identifiers from the list are likely to be.</p>
2218
</div>
23-
2419
<div class="about-page__half--right">
2520
<h2>Why?</h2>
26-
27-
<p>Because we want to see data that uses <strong>open</strong> and <strong>interoperable</strong> organization identifiers. </p>
28-
<p>When creating, publishing or using data about organizations it is important to clearly identify the organizations in question. </p>
29-
<p>But there can be hundreds of organizations with the same or similar names. A single name might also be written many different ways. As a result, datasets often include identifying numbers or codes. </p>
30-
<p>These identifiers may be drawn from official registers, or might be maintained by a single organization. The quality of lists varies in terms of their coverage, quality and the depth of information they provide.</p>
21+
<p>org-id.guide has been created by a partnership of open data standards groups in order to provide a robust, shared approach to the use of <strong>open</strong>, <strong>interoperable</strong> and <strong>unambiguous</strong> organisations identifers.</p>
22+
<p>It is a collaborative project, designed to fill a gap in our shared data infrastructure.</p>
3123
<p>With org-id.guide you can:</p>
32-
3324
<ul>
34-
<li><p>Say which list an identifier is taken from - increasing data interoperability;</p></li>
25+
<li><p>Declare which list an identifier is taken from - increasing data interoperability;</p></li>
3526
<li><p>Identify the best lists to use for new datasets - promoting openness;</p></li>
3627
<li><p>Find out where to look up more information on an organization - improving analysis and data quality; </p></li>
3728
<li><p>Discover crosswalks between different lists - supporting joined-up data;</p></li>
3829
</ul>
39-
</div><br/><br/><br/>
30+
<p>The members of the org-id.guide initiative use the register as a codelist to validate data, and to populate data entry user interfaces so that good quality data is created at source. </p>
31+
</p>
32+
</div><br/><br/><br/>
4033

41-
<div>
42-
<h1 class="about-page__header">How do I use it?</h1>
43-
</div>
44-
45-
<div class="about-page__half--left">
46-
<h2>Data creators</h2>
47-
48-
<p>Collecting or publishing data about organizations? </p>
49-
<p><strong>First</strong>, make sure you are collecting an identifier for each organization, as well as a name. You can lookup the best identifier list to use based on the country, organization type, or sector you are managing data for.</p>
50-
<p><strong>Second</strong>, when you store and publish data about an organization, use the list code code for the organization identifier list so that data users know which list the identifier is from.</p>
51-
<p>You can do this by combining the list code and identifier in a single string:</p>
52-
53-
<p>E.g.<p>
5434

35+
<div>
36+
<h1 class="about-page__header">How do I use it?</h1>
37+
</div>
38+
<div class="about-page__half--left">
39+
<h2 id="data-creators">Data creators</h2>
40+
<p>Are you collecting or publishing data about organizations? </p>
41+
<p><strong>First</strong>, make sure you are collecting an identifier for each organization, as well as a name. You can lookup the best identifier list to use based on the country, organization type, or sector you are managing data for.</p>
42+
<p><strong>Second</strong>, when you store and publish data about an organization, use the list code code for the organization identifier list so that data users know which list the identifier is from.</p>
43+
<p>You can do this by combining the list code and identifier in a single string:</p>
44+
<p>E.g.<p>
5545
<code class="about-page__code">GB-COH-09506232</code>
56-
5746
<p>Or separating out the list code into it’s own field:</p>
58-
5947
<p>E.g.</p>
60-
<pre><code class="about-page__code">{
61-
"scheme": "GB-COH",
62-
"id": "09506232
63-
}</code></pre>
48+
<pre><code class="about-page__code">{
49+
"scheme": "GB-COH",
50+
"id": "09506232
51+
}</code></pre>
52+
53+
</div>
54+
<div class="about-page__half--right">
55+
56+
<h2 id="data-users">Data users</h2>
57+
<p>If you’ve come across an organization identifier, you can use org-id.guide to find out more about it and where to locate related open data.</p>
6458

65-
<p><strong>P.S.</strong> The more additional identifying information you can provide for each organization, the better. See our tips on organization information page (forthcoming).</p>
59+
<h2>Data contrbutors</h2>
60+
61+
<p>We welcome new submissions to org-id.guide. The <a href="http://docs.org-id.guide">contributors handbook</a> details how you can submit a request or proposal for a new list to be included. New submissions are reviewed by the org-id.guide members</p>
62+
<p>You can:</p>
6663

67-
<h2>Data users</h2>
64+
<ul>
65+
<li><p>Request research to identify an appropriate list</p></li>
66+
<li><p>Proposa a new list</p></li>
67+
<li><p>Propose changes to an existing list in the register</p></li>
68+
</ul>
6869

69-
<p>If you’ve come across an organization identifier, you can use org-id.guide to find out more about it and where to locate related open data.</p>
70+
<p>Following a light research process, new entries can be included in the codelist within 7 days. Entries are never removed from the downloadable list, but may be deprecated.</p>
7071

71-
<h2>How is org-id.guide populated?</h2>
72+
</div><br/><br/><br/>
7273

73-
<p>We started out with the <a href="http://iatistandard.org/202/codelists/OrganizationRegistrationAgency/">IATI Registration Agency codelist</a>, and we have been working to add to this through detailed research - keeping our research <a href="https://airtable.com/shrsA8pTLjBiR6SVs">in AirTable here</a>.</p>
74-
<p>We are developing a <a href="https://docs.google.com/document/d/1lkLjHxXaH9GuAR_g-pv9Qru28f1EeOMZtwXduVboMa4/edit?usp=drive_web">research handbook</a> to guide population of the register.</p>
7574

76-
<h2 id="who-is-responsible-for-orgprefixcodes">Who is responsible for org-id.guide?</h2>
77-
<p>The proof-of-concept is being developed by <a href="http://www.opendataservices.coop">Open Data Services Co-operative</a> for a group of partners including: <a href="http://juds.joinedupdata.org/">Joined Up Data Standards</a>, the <a href="http://www.iatistandard.org">International Aid Transparency Initiative</a>, <a href="http://www.resourcegovernance.org/">Natural Resource Governance Institute</a>, <a href="http://www.threesixtygiving.org">360Giving</a>, the <a href="https://www.interaction.org/project/open-ag-funding/overview">Initiative for Open Ag Funding</a> and <a href="http://www.open-contracting.org">Open Contracting</a>. </p>
78-
<p>We plan to open up this group to wider participation, and to develop an ongoing governance model for the project over early 2017.</p>
79-
<p>For more information contact <a href="mailto:[email protected]">[email protected]</a></p>
75+
<div>
76+
<h1 class="about-page__header">More info</h1>
77+
</div>
78+
<div class="about-page__half--left">
79+
<h2 id="who-is-responsible">Who is responsible for org-id.guide?</h2>
80+
<p>The register is maintained by <a href="http://www.opendataservices.coop">Open Data Services Co-operative</a> for a group of partners including: <a href="http://juds.joinedupdata.org/">Joined Up Data Standards</a>, the <a href="http://www.iatistandard.org">International Aid Transparency Initiative</a>, <a href="http://www.resourcegovernance.org/">Natural Resource Governance Institute</a>, <a href="http://www.threesixtygiving.org">360Giving</a>, the <a href="https://www.interaction.org/project/open-ag-funding/overview">Initiative for Open Ag Funding</a> and <a href="http://www.open-contracting.org">Open Contracting</a>. These members have a role in the governance of the register.</p>
81+
<p>You can find out <a href="http://docs.org-id.guide/en/latest/members/">more about membership of the initiative here</a></p>
82+
83+
<p>For more information contact <a href="mailto:[email protected]">[email protected]</a></p>
8084
</div>
81-
8285
<div class="about-page__half--right">
83-
<h2>What is an organization identifier list?</h2>
84-
85-
<p>Our register includes any lists which provide at least an identifying number or code and an organization name for any collection of organizations: from companies and charities, to government bodies and unincorporated associations.</p>
86-
<p>We collect metadata about each list to describe the kinds of organizations it includes, the jurisdictions it covers, the nature of entries in the list, and whether the list is available as open data.</p>
87-
<p>Using this metadata, we encourage data publishers and users to prefer:</p>
88-
<ul>
89-
<li>
90-
<strong>Primary over secondary lists</strong>.
91-
<p>A primary list is one which directly and unambiguously identifies a particular legal entity. For example, company registration numbers are usually primary identifiers. You cannot be a company without a company number, and you cannot have a company number without being a company.</p>
92-
<p>Secondary lists don’t have this constraint. They contain identifiers assigned to organizations, but where it may be possible: (a) for organizations to receive more than one identifier; (b) for organizations to change their status without this being reflected in the list; (c) the list does not comprehensively cover all organizations of a particular type. </p>
93-
</li>
94-
<li>
95-
<strong>Secondary over local lists</strong>.
96-
<p>Some data publishers have their own lookup lists of organizations and identifiers. When primary or secondary identifiers are not available, publishing these can be useful to enable more joined up data.</p>
97-
</li>
98-
</ul>
99-
<p>Note that we only provide a register of the lists: we don’t store or provide the actual organization identifier entries. You will need to follow the links from the register to the websites of each identifier list to find and validate the identifiers these provide.</p>
100-
<p>Services like OpenCorporates provide a very useful search across a wide range of official identifier lists, particularly for companies. </p>
86+
<h2 id="history">History</h2>
87+
<p>org-id.guides started as a sanctioned fork of the <a href="http://iatistandard.org/202/codelists/OrganizationRegistrationAgency/">IATI Registration Agency codelist</a> in September 2016. A full revision history of the register itself can be found via GitHub.
10188
</div>
10289
</div>
10390
</main>

0 commit comments

Comments
 (0)