Skip to content

Latest commit

 

History

History
47 lines (27 loc) · 3.19 KB

README.md

File metadata and controls

47 lines (27 loc) · 3.19 KB

OpenGovLD

Join the chat at https://gitter.im/OpenGovLD/specs

This page is work in progress and will be translated to English. So far there exists a Wiki page: https://github.com/OpenGovLD/specs/wiki

The main part of the specification will be machine readable. Therefore only a small amount of text of the specification will only be readable by humans.

To support the W3C Semantic Web logo the specification will enable five star open Web data-conformance.


In diesem Repository wird die Spezifikation erarbeitet. OpenGov spezifiziert eine einheitliche Schnittstelle zum Abruf von öffentlichen Informationen aus parlamentarischen Informationssystemen.

Original: Editieren, Änderungen nachvollziehen

Wenn Du Dich für die Quellen des Dokuments sowie für das Nachvollziehen von Änderungen an den Quellen interessierst, findest Du dies im Ordner:

dokument/master

Die Quelldateien sind reine Textdateien (Zeichensatz: UTF-8) mit Markdown-Formatierung (Dateiendung: .md).

Änderungswünsche am Dokument können in Form von Pull Requests beigesteuert werden. Dazu erzeugst Du zunächst einen Fork dieses Repositories. Dann committest Du Änderungen an Deinem Fork. Danach kannst Du am einzelnen Commit die Funktion "Send Pull Request" auslösen.

Übrigens: prose.io ist ein fantastischer Web-basierter Editor, mit dem Du die Markdown-Dateien in Deinem eigenen Repository spielend im Browser bearbeiten kannst.

Änderungsinfos können übrigens in Form eines Atom Feeds abonniert werden.

Derivate: Bequemes Lesen auf verschiedenen Geräten

Es stehen Versionen des Dokuments in vielen Formaten zur Verfügung:

ACHTUNG: Gegenwärtig sind dies noch unmodifizierte Kopien der OParl-Dokumente des Stands unmittelbar vor dem "JSON-LD Rückbau".

Eine einfache Textersetzung von "OParl" durch "OpenGovLD" ist erst sinnvoll, wenn ein Teil der Texte manuell überarbeitet ist. Das betrifft z.B. die Historie. Nach aktuellem Stand wird es für OpenGovLD möglicherweise nur noch eine HTML-Serialisierung geben, die auf der von zahlreichen Arbeitsgruppen des W3C verwendeten ReSpec basiert - und deren nicht maschinenlesbarer Teil sehr viel kürzer ist als der bisherige Entwurf der OParl-Spezifikation.

Die Derivate werden mit Pandoc erzeugt. Das Script unter 'scripts/create_documents.sh' automatisiert diesen Vorgang.