BUGS > Manual / Handbuch

 Ist das Handbuch ein Fehler?

(1/3) > >>

michaa7:
Auf jede Gefahr hin ...

Eben suchte ich wie ich genau Grub neu installiere und wollte das im Siduction Manual nachschlagen.

Ich habe jetzt im neuen Manual bestimmt mehr als 10 Minuten gesucht und nicht gefunden wie ich Grub installiere. Ich habe gar nichts zu Grub gefunden, nicht mal das Wort. Vielleicht steht das nicht mehr drin ... dann wäre dies ein Manko, oder es steht drin und ist, was ich befürchte, unauffindbar außer für diejenigen die genau wissen wo es steht weil sie Stunden und Tage damit verbracht haben, das Handbuch zu schreiben und zu gestalten. Diejenigen werden meine Kritik vermutlich auch nicht nachvollziehen können, weil sie ja wissen wo alles zu finden ist.
Für Otto-Normalnachschauer ist das Handbuch: unübersichtlich und aufgebläht ...
... und für diejenigen, die es erstellt haben wichtiger als für die für welche es eigentlich gedacht ist ...

Die alte Version war prägnant gegliedert, die neue ist eine zusammengeschobenen Ansammlung von Themen.

Ich schreibe das hier nicht um jemanden zu ärgern, sondern obwohl ich davon ausgehe dass dieses Posting mir Ärger bereiten wird!

edlin:
Hallo michaa7,

ich weiß ja nicht, wie du im Handbuch suchst, aber ich finde zumindest 37 mal das Wort grub. Das heißt nicht automatisch, dass die Fundstellen deine Fragen beantworten, aber der Aussage
--- Quote ---Ich habe gar nichts zu Grub gefunden, nicht mal das Wort.
--- End quote ---
kann ich nicht so ganz folgen. Aber wir helfen ja gerne: Suche einfach mal im PDF-Manual mittels Strg-F nach grub!

Oder soll ich es so verstehen, dass du uns die Mitarbeit am Manual anbietest? Dann steht es dir frei, dem Manual eine einheitliche Handschrift und Struktur zu verleihen. Denn ja, das Manual ist von mehreren Helfern erstellt und realisiert worden und daher nicht ganz so konsistent wie die Aufbauanleitung für ein IKEA-Regal.

Solltest du allerdings nur Hilfe zur Installation von siduction und grub suchen, so ist deine Frage hier etwas fehl am Platz.

edlin   

michaaa62:
Hallo michaa7,
das Problem mit dem noch nicht vervollständigtem Manual hatte ich letztens ebenso. Ich habe dann archive.org bemüht, um die Schritte für die Neuinstallation nachzulesen, z.B. hier https://web.archive.org/web/20160305225109/http://manual.siduction.org/sys-admin-grub2 Viel Erfolg!

@edlin Kannst du mich in die richtige Richtung weisen, damit ich das Manual ergänze?

hendrikL:
https://github.com/siduction/sidu-manual/wiki/DE_Home

https://github.com/siduction/sidu-manual/issues

Handbuch klonen, entsprechende Seite bearbeiten und einen pull-request stellen.
https://github.com/siduction/sidu-manual

Ps.: Die entsprechende Seite hat es noch nicht wieder ins Handbuch geschafft, da sie einer massiven Überarbeitung bedarf.
 https://github.com/siduction/sidu-manual/blob/WIP/data/de/sys-admin-grub2_de.md

Dort sind noch mehr Seiten, die auf eine Überarbeitung warten. Zurzeit sind sehr wenige dabei, am Handbuch zu arbeiten.
Menschen mit entsprechenden Fachkenntnissen und auch diejenigen die konstruktiv Helfen wollen und können sind jederzeit willkommen.
Verbesserungen, neue Themen können gerne via Pull Request eingereicht werden.
Auch kann ein "Issue (Bug)" eröffnet werden, nur sollte die Kritik und Vorschläge Konstruktiv sein!

michaa7:
Danke für eure Antworten.

Meine Kritik bezieht sich auf das online Manual:
https://manual.siduction.org

Und die beginnt schon mit dem *starren* Layout, insbesondere für Leute die vernünftige Schriftgrößen im Gegensatz zu "möglichst viel auf den Bildschirm quetschen" bevorzugen:

Nein, meine Schriftgröße ist nicht ungewöhnlich groß, sondern einfach augenschonend. Das ist das orginal im Browser auf 160% gezoomt.
Das ist 100%:

Klar kann man das lesen. aber das ist bei längerem lesen nicht augenschonend. Und darüber gibt es nichts zu diskutieren. Das gibt es nur zu akzeptieren (oder wie das meistens ist: abzulehnen).
Bis zum alter von ca. 40 Jahren hatte ich nah und fern Adleraugen. Es war die Computerarbeit die die in einem erschreckenden Maße geändert hat. Und an dieser Volkskrankheit arbeit man mit oder man wirkt ihr entgegen.

Nur das war ja nicht der unmittelbare Anlaß meiner Kritik. Das war ja die Suche nach hinweisen zu Grub. Das Inhaltsverzeichnis ist schon rein optisch (screenshot 100%) unergonomisch, inhaltlich mehr verwirrend als Orientierung gebend. ***Wer das anders sieht, mit dem ist die Diskussion bereits beendet.*** Nicht weil ich nicht will sondern weil das von Beginn an falsch abgebogen ist, gedanklich. Und  derartiges eignet sich nicht zu demokratischen Abstimmungsergebnissen.

Das sollte jemand federführend machen, der das genau so sieht (und damit meine ich ganz sicher nicht mich). In Ermangelung dessen wäre es immer noch besser die Struktur des alten Handbuchs unverändert zu übernehmen (und allenfalls vorsichtig zu *ergänzen, z.B. mit dem Punkt "systemd" an geeigneter Stelle). Das wäre ein Fortschritt gegenüber der neuen Gliederung. Technisch wie inhaltlich soweit es die Übersicht und Orientierung betrifft.

Konstruktiver geht es von meiner Seite aus nicht. Und soweit es mich betrifft endet hier meine Teilnahme an diesem Thread.

Navigation

[0] Message Index

[#] Next page