search

bundestag / gesetze

Bundesgesetze und -verordnungen
http://bundestag.github.io/gesetze/
The Unlicense
1.69k stars 155 forks source link

Dokumentation der Struktur #7

Open mnagel opened 12 years ago

mnagel commented 12 years ago

Die Struktur des Repos sollte besser dokumentiert werden. Augenscheinlich gibt es für jeden Buchstaben einen Ordner (um die Anzahl der jeweiligen Unterordner klein zu halten(?)) und darin pro Gesetz einen Ordner benannt nach dem Kurznamen des Gesetzes (?) und darin eine index.md. Ist das so korrekt? Was sind die Gründe für diese Struktur?

Was ist das eigentliche Endprodukt / wie ist die Nutzung des Repos gedacht / welche Use-Cases gibt es? Klickt man sich auf https://github.com/bundestag/gesetze durch? Öffnet man das Repo lokal in gitk/gitx/tortoise? Sollte es einen STRG-F-durchsuchbaren Index mit den ausgeschriebenen Namen geben? Wie wird dieser generiert?

mnagel commented 12 years ago

bei Twitter gefunden: http://bundestag.github.com/gesetze/ das sollte z.B. auch in der Readme erwähnt werden...

stefanw commented 12 years ago

Die Anfangsbuchstabe-Unterordner-Struktur ist tatsächlich damit man nicht 6000+ Ordner in einem hat.

Die Gesetzdatei heißt index.md, weil:

Wie man dieses Repo nutzt ist noch nicht ganz klar. Es gibt aber fantastische Möglichkeiten.

Die gerenderten Gesetze aus dem gh-pages Branch sind noch sehr grob, ohne CSS, deswegen wurden sie noch nicht in der README erwähnt.

Es ist angedacht die gerenderten Gesetze per JavaScript mit der GitHub API zu verbinden und Pull Request-Änderungen oder Issues direkt am gerenderten Gesetz anzuzeigen.

surma commented 12 years ago

@mnagel Nach Dateinamen lässt sich schon über die Github-Oberfläche suchen, wenn man [t] drückt.

rriemann commented 12 years ago

We should consider to build the html representation on top of middlemanapp or octopress (octopress is a more feature-rich template/plugin set for jekyll). http://middlemanapp.com/ http://octopress.org/