Open Data Policies Decoded is a free, open source, web-based application to provide better access to open data policies from various jurisdictions (starting with US cities) online. It's a project based on ("forked from") The State Decoded, but differs in that rather than making all the laws within a jurisdiction more accessible, Open Data Policies Decoded provides this function for laws/policies related to open data across various jurisdictions. By utilizing State Decoded XML Documentation to structure open data policy text, Open Data Policy Decoded makes the language of open data reform more searchable, interconnected, and machine-readable, adding an API, bulk downloads, and semantic analysis tools.
By providing easier to read, more useful, and more open open data policies our goal is to empower government officials and open government advocates alike to more easily mix and match the best aspects of various open data policies "re-forming" reforms and ultimately facilitating the spread of good policy ideas across jurisdictions in the true spirit of open source culture.
-
Convert your open data policy into raw text.
-
If you need to extract the text from a PDF we recommend using a e PDF OCR tool. For Windows we like FreeOCR.
-
Remove formatting but keep all returns and line information
-
Optional Submit a Github issue to for us to add your policy to our raw text repository.
-
Convert raw text into The State Decoded XML format. If you have your policy as XML, you can adapt the provided XSLT to transform it into the proper format. Or if you don't have your policy as XML, you can convert it into XML. Use the current policy XMLs as an example. 1.for the
<unit label="section" identifier="amherstny" level="1">Amherst, NY</unit>
section insert "citystate" in the identifier section as Lower caps ,no spaces or commas. (This is important as the import will fail if there are any any characters) and City, State after the level="1" text. -
for the
<section_number>Amherst,NY(2014)</section_number>
Insert the city,state(year) with no spaces -
for the
<catch_line>Legislation (2014)</catch_line>
place the law type (Executive order, legislation, ordinance) and the year of adoption. -
Copy the body of the policy between the tags. Add
<p>
before every line and a</p>
after every line. -
between the
<history> </history>
tags put notes/resolution/executive order/references and voting history in this area. such as > (Adopted on, council votes, date etc). At insert the following information. > Enacted: 2014; > Link: http://amherstny.iqm2.com/Citizens/FileOpen.aspx?Type=12&ID=1239&Inline=True; > Means: Legislation -
Copy the XML File into the [/htdocs/admin/import-data folder] (https://github.com/sunlightlabs/opendatapoliciesdecoded/tree/master/htdocs/admin/import-data). You can Submit an issue to request for a Sunlight Foundation Staff to do this for you.
-
Submit an issue to this repo asking to "Import the database" Only Administrators can do this.
Project documentation can be found at docs.statedecoded.com, which explains how to install the software, configure it, customize it, use the API, and more. The documentation is stored as a GitHub project, with its content automatically published via Jekyll, so in addition to reading the documentation, you are welcome to make improvements to it!
- Use Open Data Policies Decoded sites and share your feedback in the form of filing issues—suggestions for new features, notifications of bugs, etc.
- Write or edit documentation on [the wiki](https://github.com/Open Data Policiesdecoded/Open Data Policiesdecoded/wiki).
- Read through unresolved issues and comment on those on which you have something to add, to help resolve them.
- Contribute code to fix bugs or add features.
- Comb through existing code to clean it up—standardizing code formatting, adding docblocks, or editing/adding comments.
Open Data Policies Decoded was developed by the [Sunlight Foundation] (http://sunlightfoundation.com/) as part of our work on the What Works Cities Initiative