[bielefeld] Umstrukturierung des Netzes
Moritz Warning
moritzwarning at web.de
So Jul 5 15:11:24 CEST 2015
On 07/05/2015 03:00 PM, Lars Kasper wrote:
> bodems <felixannen at web.de> schrieb:
>
>> und dass die Dokumentation schlecht ist.
>
> Das kann ich so nicht stehen lassen.
>
> »Schlecht« ist die Dokumentation sicher nicht, man kann etwas damit anfangen. Aber sie darf (und muß, wenn man mehr Leute zum Mitmachen im Maschinenraum bewegen möchte) noch besser werden.
>
> Dazu gehört zum Beispiel:
>
> * Hardware- und vertragliche (Bandbreite, Traffic) und finanzielle (monatliche Kosten bei gewissen Beispiel-Setups) Voraussetzungen am Anfang erwähnen.
> * Entscheidung, was man warum im Wiki oder auf Github dokumentiert. (Ein bißchen hier und ein bißchen dort macht es schwierig nachzuvollziehen. Möglich wäre zum Beispiel ein »Big Picture«-Überblick im Wiki und konkrete Installationsschritte auf Github; jeweils verlinkt.)
> * Eine ausführlichere Dokumentation des Skripts setup_server.sh. (Kommentare zu jedem Abschnitt, wofür das so gemacht wird: für was ist das Programm zuständig, warum kommt das von irgendeiner Dritt-Website (weil es kein Debian-Paket dafür gibt), wieso wird das so konfiguriert? Möglicherweise auf alternative Wege hinweisen (zum Beispiel: Ist nginx oder Apache statt lighttpd möglich?).)
> * Welche VPN-Anbieter sind empfehlenswert?
> * Sicherstellen, daß es tatsächlich so funktioniert und auf aktuellem Stand ist.
>
> Das alles sollte nicht den Eindruck entstehen lassen, die Dokumentation sei »schlecht«.
>
> Wie geschrieben, wenn ich Zeit für eine Gateway-Testinstallation finde, werde ich mich da gerne einbringen.
>
>
> Mit internettem Gruß
>
> Lars Kasper
>
>
>
Im wiki gibt es zwei Dokumentationen. Die eine für das alte Netz 0.3.x) und eine angefangene (aber nicht fertig gestellte)
für das neue Netz (>=0.4).
Ich hatte dann mal angefangen auf github zu dokumentieren:
https://github.com/freifunk-bielefeld/docs
viele Grüße,
mwarning
-------------- nächster Teil --------------
Ein Dateianhang mit Binärdaten wurde abgetrennt...
Dateiname : signature.asc
Dateityp : application/pgp-signature
Dateigröße : 473 bytes
Beschreibung: OpenPGP digital signature
URL : <http://lists.freifunk.net/pipermail/bielefeld-freifunk.net/attachments/20150705/aa19c703/attachment.sig>
Mehr Informationen über die Mailingliste bielefeld