Du bist nicht angemeldet.

#1 31.03.2013 17:27:30

Ovion
Mitglied

[Wiki] Überarbeitung der Anleitung für Einsteiger

So, nachdem die Diskussion bzgl. der Vergabe der Linkplätze auf archlinux.de zu einem Ende geführt wurde, sollten wir uns mal die Anleitung für Einsteiger vornehmen, desbezüglich die Diskussion im anderen Thread ja schon angerissen wurde.

Bisher stehen zwei grundsätzliche Möglichkeiten im Raum:
* Die Anleitung als solches stehen zu lassen
* Die Anleitung zu entfernen und aus Wikiartikeln zusammensetzen (die dann entsprechend um Informationen erweitert werden müssten), die man dann als eine Seite aufrufen kann

Die Erhaltung der Anleitung als eigene Seite in der einen oder anderen From ist, ich hoffe, ich fasse das jetzt zusammen, ohne etwas zu vergessen, deshalb sinnvoll, weil man, wenn man einen Rechner auf Arch migriert und keine Zweitrechner zur Verfügung hat, möglicherweise eine Seite braucht, die man sich ausdrucken und danebenlegen kann und die einen mit hinreichender Sicherheit zu einem System mit X-Server, Internetverbindung und Browser führt, von dem aus man sich weiter durch's Wiki wühlen kann. Denn wenn man erstmal begonnen hat, den eigenen Rechner neu aufzusetzen, ist üblicherweise nicht mehr viel mit "mal eben ins Arch-Wiki gucken, wie das denn noch gleich ging". Dementsprechend müsste die Anleitung/Druckvorlage/wasauchimmer zumindes alle Informationen enthalten, die hierfür nötig sind.


Ergänzungen in der Einleitung kann ich auf Wunsch gerne vornehmen.
#####################



Ich persönlich spreche mich für eine Erhaltung der Anleitung als separate Seite aus, da man aus diesem Grund die Leute bei der Einsteigeranleitung bereits mit grundlegenden Konzepten bzgl. Arch vertraut machen kann. Ginge die Anleitung in anderen Seiten auf, würden diese "Neulinginfos", befürche ich, am Ende an vielen Stellen des Wikis auftauchen und die Artikel dort entsprechend komplexer machen. Daher bin ich für eine separate geführte Installation, nach der jeder soweit mit den Arch-Werkzeugen und Konzepten vertraut ist, dass man sich im Wiki zurechtfinden kann, ohne das jeder Artikel spezielle Kommandos für Anfänger braucht.

Gleichwohl sehe ich ein, dass die Einsteigeranleitung überaus umfangreich und dementsprechen unschön zu warten ist. Ich denke, dass sich die Anleitung für Anfänger an einigen Stellen kürzen ließe bzw. Dinge drinstehen, die nicht für den Weg "X, Internet, Browser" nötig sind, daher schlage ich vor, diese in andere Artikel auszugliedern.

Ich blase jetzt einfach mal raus, was ich glaube, was man aus der Einsteigeranleitung noch kürzen könnte, damit das Gerät vielleicht nicht ganz so ausladend wird.

  • Beziehen des isos und auf passenden Datenträger verfrachten nur sehr knapp halten, das kann man zur Not in einen eigenen Artikel auslagern, weil Vorinstallatives Geplänkel

  • Cronjobs raus

  • "Automatische Zeiteinstellung" ist unter "weitere notwendige Dienste" schon hinreichend abgehandelt für die Einsteigeranleitung, alles weitere in entsprechenden Artikeln

  • netcfg raus, für die Installation reicht wpa_supplicant, wenn's schon kein Kabel gibt, völlig

  • alles unterhalb von "CPU Frequenz Skalierung" kann imo auch in einen eigenen Artikel, ist zwar schön, aber die Einsteigeranleitung soll meines Erachtens helfen, eine funktionierende Ausgangsbasis zu schaffen, insofern > eigene Artikel

  • Dementsprechend dann einfach die "Weitere Informationen"-Liste am Ende verlängern, wenn X erstmal läuft und man einen Terminalemulator und Browser sowie Internet hat (die Paketnamen sollte man da vielleicht noch eben erwähnen, ist ja nur eine Zeile), kommt man entsprechend auf archlinux.de bzw. im Wiki weiter und kann sich an den weiterführenden Infos austoben

Gerade der vorletzte Punkt spart mal eben 19 Überschriften (according to Inhaltsverzeichis), die zwar interessant sein mögen, aber in der Anleitung selbst imho überflüssig sind. Die machen sich besser auf eigenen Seiten und die Einsteigeranleitung wird übersichtlicher und weniger Moloch. Aufgrund der Tatsache, dass es eben eine Einsteigeranleitung ist, wird es auch schwierig, es aus separaten Artikeln zusammenzusetzen. Da ist die Anleitung als ein Artikel vielleicht sogar besser, um nicht das Wiki mit Anmerkungen zur Erstinstallation zu fluten. So kommen alle Einsteigerinformationen in diese Anleitung und man kann im Rest des Wikis davon ausgehen, dass diese Dinge eben bereits mindestens einmal gemacht worden und damit bekannt sind.

Damit würde die Einleitung für Einsteiger auch schlanker und damit auch schöner, einfacher wartbar, übersichtlicher, etc. Und vermeidet Redundanz, denn das oben angemerkte ist imho besser in eigenen Artikeln aufgehoben.

Gerade aus der Laptop-Sparte der Einsteigeranleitung könnte man vielleicht sogar einen eigenen Artikel "Spezielle Tweaks für Laptops" oder so machen, wenn's die Seite nicht ohnehin schon gibt. Da könnte man dann alle Infos oder Verweise auf andere Artikel reintun, die für Laptopnutzer interessant sind, laptop-mode-tools, Stromsparen und so.

Möge die Diskussion beginnen und möget ihr meine Vorschläge zerreißen/ergänzen/weitere einbringen/etc.!

Beitrag geändert von Ovion (31.03.2013 17:38:59)

Offline

#2 31.03.2013 18:53:36

Dirk
Moderator

Re: [Wiki] Überarbeitung der Anleitung für Einsteiger

Ovion schrieb:

* Die Anleitung zu entfernen und aus Wikiartikeln zusammensetzen (die dann entsprechend um Informationen erweitert werden müssten), die man dann als eine Seite aufrufen kann

Ich wäre da eher für ein Mischding. Die Anleitung als solche sollte schon speziell auch für eine Erstinstallation herhalten können, mit entsprechenden Texten. Dank Transclusion muss aber nicht alles neu geschrieben werden, was schon als Artikel existiert.

Dazu muss alles um eine Überschriftenebene hochgeschoben werden, und schon passt es mit den einzelnen Artikelüberschriften, die ja alle ab der zweiten Ebene anfangen wieder: Ausgabe, Quelltext.

Ovion schrieb:

Gleichwohl sehe ich ein, dass die Einsteigeranleitung überaus umfangreich und dementsprechen unschön zu warten ist.

Wenn sie nur Umfangreich wäre, wäre das eine Sache, das eigentliche Problem ist die Redundanz, die dadurch entsteht: Vieles, was in anderen Artikeln bereits „Wikikonform“ (vgl. u.A. Artikelstil) und in aller Ausführlichkeit behandelt wurde, wird in der Anleitung „unvollständig angerissen“.

Ovion schrieb:

Ich blase jetzt einfach mal raus, was ich glaube, was man aus der Einsteigeranleitung noch kürzen könnte, damit das Gerät vielleicht nicht ganz so ausladend wird.

Ziel sollte sein, ein grafisches System zu bekommen. Hierzu braucht es gar nicht viel.

  1. Beschaffen des Images und Vorbereiten des Installationsmediums

  2. Partitionierung der Festplatte und Erstellung der Dateisysteme

    • Gpt

    • UEFI Installation

    • Erstinstallationsspezifischer Abschnitt zur Partitionierung mit „normaler Partitionstabelle“ und fdisk

  3. Netzwerkverbindung (Ethernet, WLAN, PPPoE) einrichten

  4. Installation und Konfiguration des Systems

    • Kann zum Teil übernommen werden, da ja nicht alle Konfigurationsdateien einen eigenen Artikel haben

  5. Installation von X

Fertig.

Philosophiererei über Rolling-Release-Distributionen, erweiterte Konfiguration des Systems, Sound, etc. etc. pp. haben meiner Meinung nach alle nichts in einer Installationsanleitung zu suchen.

Natürlich müssen einige Artikel dahingehend angepasst werden, dass das Thema da auch wirklich behandelt wird, und nicht einfach auf die Installationsanleitung verwiesen wird. Die Artikel sollten sowieso jeder für sich und in sich geschlossen benutzbar sein. Nur so bringt Transclusion auch wirklich was.

Der eine oder andere Artikel (Partitionierung, WLAN-Einrichtung, etc.) müsste natürlich noch erstellt werden. Wenn der Artikel aber existiert, gibt es gleich zwei Vorteile: Er kann in der Anleitung eingebunden werden, und steht zudem als eigenständiger Artikel für alle im Wiki.

Ovion schrieb:

Gerade aus der Laptop-Sparte der Einsteigeranleitung könnte man vielleicht sogar einen eigenen Artikel "Spezielle Tweaks für Laptops" oder so machen,

Wir haben ja schon die Kategorie Energieverwaltung. Entsprechende Tweak-Artikel könnten da ja mit rein (außer der inzwischen eigentlich überflüssigen Laptop-Mode-Tools und xrandr – das schon behandelt wird – für die Monitor/Beamer/Display-Umschaltung wüsste ich spontan aber nichts).

Offline

#3 31.03.2013 19:18:52

Ovion
Mitglied

Re: [Wiki] Überarbeitung der Anleitung für Einsteiger

Kann man mit Transclusion auch einzelne Teile aus anderen Artikeln rauspflücken? Namentlich kommt im gpt-Artikel (nach einer Reihe von Zeugs, das da nicht reingehört) die Partitionierung mit fdisk+gpt, dann was zur Archinstallation und dann was zu grub2. Für die Einsteigeranleitung müssten wir bspw. genau den Partitionsteil sowie die Grub-Fehlermeldung rausklauben. Ginge das?

Davon abgesehen fällt mir gerade noch ein: Grub2 komplett aus der Einsteigeranleitung raus und nur syslinux rein. Ist meiner Meinung nach wesentlich einfacher zu konfigurieren und lässt sich nachträglich problemlos ändern.

Wir sollten auch überlegen, ob wir Systemvollverschlüsselung in irgendeiner Form erwähnen oder es komplett ignorieren wollen. Ich fände es ganz sympathisch, das an prominenter Stelle zumindest deutlich zu erwähnen und es ist nun nicht so kompliziert. Denn wenn das System erstmal steht und eingerichtet ist, werden die wenigsten dafür eine komplette Neuinstallation machen, während sie es direkt bei der Installation vielleicht gewählt hätten.

Die Kategorie Energieverwaltung wäre ein prädestinierter Kandidat für die "weiteren Infos".

Offline

#4 31.03.2013 19:27:12

Dirk
Moderator

Re: [Wiki] Überarbeitung der Anleitung für Einsteiger

Ovion schrieb:

Kann man mit Transclusion auch einzelne Teile aus anderen Artikeln rauspflücken?

Dazu müsstest du vorher im Artikel, der eingebunden werden soll, entweder mit <noinclude> oder <includeonly> entsprechende Teile markieren. Aber das ist dreckig, nicht Zielführend, und geht am eigentlichen Problem vorbei …

Ovion schrieb:

Namentlich kommt im gpt-Artikel (nach einer Reihe von Zeugs, das da nicht reingehört) die Partitionierung mit fdisk+gpt, dann was zur Archinstallation und dann was zu grub2.

… das ist das, was ich meine: Viele Artikel müssen atomarer werden, und tatsächlich nur EIN Thema behandeln, ohne irgendwelche anderen „irrelevanten“ Sachen. Dann kann man die Artikl nämlich tatsächlich so wie sie sind einbinden.

Ovion schrieb:

Grub2 komplett aus der Einsteigeranleitung raus und nur syslinux rein.

Natürlich. Installation per USB, GPT, syslinux. Jeder, der bewusst was anderes will, wird dafür seine Gründe haben, und sich entsprechend selbst informieren können.

Ovion schrieb:

Wir sollten auch überlegen, ob wir Systemvollverschlüsselung in irgendeiner Form erwähnen oder es komplett ignorieren wollen.

Eventuell im Notebookabschnitt erwähnen, ansonsten ignorieren, selber Grund wie bei GRUB2/syslinux. Es ist eine EINSTEIGERanleitung. Ein Einsteiger braucht keine 10 verschiedenen Wege, sondern 1→2→3→Fertig. Jeder der unbedingt hier und da irgendwas anders oder speziell haben will, ist kein Einsteiger mehr.

Offline

#5 31.03.2013 23:29:30

I-Catch
Gast

Re: [Wiki] Überarbeitung der Anleitung für Einsteiger

da ich als Anfänger erst vor kurzen Arch installiert habe, wollte ich mal meine Meinung zur Diskussion beitragen:

Meiner Meinung kann man das gesammte Vorwort in eine eingen Eintrag packen und in der Anleitung verlinken also zb so: "Zuerst muss man sich das Image runterladen und auf das bevorzugte Startmedium kopieren. Näheres sihe hier."

dann fängt halt die eingetliche Anleitung mit den loadkeys Sachen an.

wie schon oben geschrieben reicht bei der Wlan Verbindung eine Art aus.
das gleiche gilt für die fstab erzeugung (ein Anfänger braucht nur eine Art)

dann zu "/etc/hosts" hier wird erst geschrieben was man ändern sollte und dann steht das man das gar nicht bräuchte --> unnötig?

beim bootloader reicht auch eine art aus.

achja ihr solltet noch dazu schreiben, dass wenn man wlan später nutzt das man wireless_tools & wpa_supplicant benötigt.

die Schönheit des Rolling-Releases kann man in den Vorwort Artikel packen

alles nach "Installation und Konfiguration von ALSA" in eingene Artikel und stattdessen nur kurz erklärt wie man seinSystem updaten und einen webbroser isntalliert dadurch können sie dann schon wieder im wiki suchen

naja ist nur mal meine Meinung
mfg

#6 15.04.2013 13:09:18

Dirk
Moderator

Re: [Wiki] Überarbeitung der Anleitung für Einsteiger

I-Catch schrieb:

[Sachen auslagern]

Genau mein Reden. Alles, was nicht explizit für die Installation eines Grundsystems von Nöten ist, raus, und in eigene Artikel. Meine Idee ist ja, sogar noch einen Schritt weiter zu gehen, und ALLES in eigene Artikel zu verfrachten, und diese dann als Installationsanleitung „Zusammenzubinden“ smile

Offline

#7 15.04.2013 15:26:32

Dings
Mitglied

Re: [Wiki] Überarbeitung der Anleitung für Einsteiger

Dirk schrieb:
I-Catch schrieb:

[Sachen auslagern]

und ALLES in eigene Artikel zu verfrachten, und diese dann als Installationsanleitung „Zusammenzubinden“ smile

So hatte ich das auch verstanden, die Idee finde ich absolut super, weil die Anleitung dann endlich wartbar wäre.  Allerdings fände ich es auch gut trotzdem eine kleine nette Einleitung zu Arch drin zu behalten. Man muss ja nicht, wie jetzt vom hundertsten ins tausendste kommen, aber ein kurzer Abriss womit man es bei Arch zu tun hat und Hinweise auf Informationsbeschaffungsmöglichkeiten (←geiles Hangmanwort smile ) hielte ich für durchaus angebracht.

Offline

#8 15.04.2013 15:43:34

Dirk
Moderator

Re: [Wiki] Überarbeitung der Anleitung für Einsteiger

Dings schrieb:

Allerdings fände ich es auch gut trotzdem eine kleine nette Einleitung zu Arch drin zu behalten. Man muss ja nicht, wie jetzt vom hundertsten ins tausendste kommen, aber ein kurzer Abriss womit man es bei Arch zu tun hat und Hinweise auf Informationsbeschaffungsmöglichkeiten (←geiles Hangmanwort smile ) hielte ich für durchaus angebracht.

Natürlich! Das Technische kommt aus den eingebundenen Artikeln, und alles, was zur Erstinstallation sonst noch dazugehört, steht eben direkt da. Allerdings brauchen wir dazu aber erst mal alles für die Installation wichtige in entsprechend atomaren  Artikeln.

Offline

#9 16.04.2013 18:11:55

Ovion
Mitglied

Re: [Wiki] Überarbeitung der Anleitung für Einsteiger

Hab nicht so den Überblick im Wiki, daher mal die Frage: Welche Teile der Einsteigeranleitung gibt es denn NICHT als eigene Artikel in geeigneter Struktur (ob alle nötigen Infos in diesen Artikeln vorhanden sind, sei für den Moment mal angenommen)? Sprich: Bei welchen Punkten müssten wir mehr machen als einen Artikel aufzuwerten?

@Dirk
Kannst du eine Einschätzung abgeben, wieviele Einzelartikel für die Einsteigeranleitung in etwa momentan zusammengebunden würden?

Offline

#10 16.04.2013 18:33:09

Dirk
Moderator

Re: [Wiki] Überarbeitung der Anleitung für Einsteiger

Ovion schrieb:

Kannst du eine Einschätzung abgeben, wieviele Einzelartikel für die Einsteigeranleitung in etwa momentan zusammengebunden würden?

Das kommt auf die Gliederung an in #2 hab ich ja schon kurz zusammengefasst, wie es aussehen könnte.

Für die Beschaffung des Installationsimages haben wir ja prinzipiell den Artikel Download, wobei der natürlich angepasst werden muss, hier könnte sogar noinclude genutzt werden, um den Vermerk auf die Installationsanleitung nicht mit zu Transkludieren, ihn aber trotzdem im Artikel zu belassen, da er ja auch von anderen Stellen aus verlinkt wird, als aus dem Wiki.

Die Installation von einem USB-Stick, bzw. das Image auf einen USB-Stick zu bekommen, wird im Wiki ja schon beschrieben, der Artikel muss nur geringfügig umformatiert, und die Einleitung neu verfasst, werden.

Mit den Artikeln zu GPT und UEFI haben wir ja schon zwei „Vor-Installations-Artikel“, aber hier wäre ich fast dafür – wenn nicht einen neuen Artikel zur Partitionierung zu verfassen – die Partitionierung direkt in der Anleitung zu behandeln, wer das Wiki nutzt braucht ja im Regelfall schon keine Partitionierung mehr smile

Zur Netzwerkverbindung brauchen wir auf jeden Fall noch einen generellen Artikel zur Einrichtung und Verwaltung des Netzwerkes, die Konfigurationsdateien können auch übernommen werden, sonst müsste für jede Datei ein Artikel erstellt werden. Eventuell kann man das auch als „Systemkonfiguration“ als einen Artikel zusammenfassen und dann Transkludieren.

In #2 dargestelltes Schema nutzend brauchen wir …

  1. … eine Anpassung des bestehenden Download-Artikels

  2. … den optimierten Artikel über das Vorbereiten des USB-Sticks

  3. … einen neu zu erstellenden Partitionierungsartikel

  4. … einen neu zu erstellenden Netzwerkinstallations- und konfigurationsartikel

  5. … den Text über die Grundinstallation des Systems aus der bestehenden Anleitung

  6. … ggf. einen Artikel „Systemkonfiguration“, der sich mit den Konfigurationsdateien auseinandersetzt

… sowie, wenn das alles da ist, eine entsprechende Zusammensetzung im Installationsartikel, um diesen dadurch zu ersetzen.

Offline

#11 02.06.2013 20:30:00

Dirk
Moderator

Re: [Wiki] Überarbeitung der Anleitung für Einsteiger

Das Thema ist zwar etwas eingeschlafen, aber ich habe mir mal erlaubt, einen Entwurf für eine mögliche technische Neugestaltung zu erstellen. Ab der Trennlinie kommt dann der eigentliche Artikel. Im Quelltext ist zu sehen, dass das alles leicht wartbare Einzelartikel sind, die dann nur „zusammengesteckt“ werden.

https://wiki.archlinux.de/title/Benutze … sanleitung

Es ist noch ein wenig Arbeit, aber wenn sich mehr als „die üblichen Verdächtigen“ finden, und wir alle Hand in Hand arbeiten, sollten wir das ohne viel Stress über die Bühne bringen können. Folgende Agenda schlage ich vor:

  1. Anpassung der transkludierten Artikel (Aktualisierung, Generalisierung, Atomisierung)

  2. Entscheidung über ggf. zusätzlich zu setzende noinclude-Tags (sollte durch Generalisierung und Atomisierung vermieden werden)

  3. Erstellung fehlender Artikel

  4. Erstellung erstinstallationsspezifischer Texte und Anleitungen, die nicht transkludiert, sondern direkt im Artikel stehen werden

  5. Weil wir eine Community sind, und ich basisdemokrat bin: Eine Abstimmung über das Endergebnis smile

  6. Übertragung aus dem zur Erstellung genutzten Autorennamensraum in den Artikelnamensraum

Wenn wir uns keinen Stress machen, und die ganze Sache ordentlich und Sauber angehen, sollten wir realistisch gesehen bis zu den Herbstferien fertig sein (ich mag keinen Zeitdruck, aber irgendwann müssen wir das Problem mal angehen) smile

Offline

#12 03.06.2013 17:31:12

Attikus
Mitglied

Re: [Wiki] Überarbeitung der Anleitung für Einsteiger

Uner Paritionierung sollte Weblinks und Quellen entfernt werden.
Zudem gibt es einige unpassende Formulierungen in Unterthemen, wie "Diese Seite soll erklären, wie man(...)paritionisiert"
MfG Attikus

Offline

#13 03.06.2013 17:36:26

Dirk
Moderator

Re: [Wiki] Überarbeitung der Anleitung für Einsteiger

Attikus schrieb:

Uner Paritionierung sollte Weblinks und Quellen entfernt werden.
Zudem gibt es einige unpassende Formulierungen in Unterthemen, wie "Diese Seite soll erklären, wie man(...)paritionisiert"

Ja, das sind die Dinge, die ich angesprochen habe smile

Offline

#14 11.02.2014 00:57:20

kill -9
Mitglied

Re: [Wiki] Überarbeitung der Anleitung für Einsteiger

Wenn ich als Einsteiger hier auch mal meinen Senf dazu geben darf:

Einer der Hauptbeweggründe (neben echtem Rolling Release, sehr zeitgemäßem Inhalt der Repos und maximaler Freiheit), Arch zu installieren, war für mich, endlich mehr über das Betriebssystem zu lernen.
Als jahrelanger Mauszeigerschubser unter div. Ubuntuversionen wollte ich endlich lernen, wie das eigentliche Linux unterhalb der GUI so funktioniert.
Gerade dabei war es für mich sehr hilfreich, eine ausführliche Dokumentation vorzufinden, die nicht nur sagt: "Tue dies und dann jenes", sondern auch erklärt, was man da eigentlich tut, so dass man die Befehle und Änderungen von Konfigurationsdateien auch (zumindest von der Idee her) logisch nachvollziehen kann.

Im Nachhinein muss ich sagen, dass gerade durch die Nachvollziehbarkeit, dessen was man tut, die Installation echt Spaß gemacht hat.
Und jetzt freue ich mich über den Erkenntnisgewinn, ein modernes System mit 2 GUIs (Cinnamon2 und Xfce4), und jederzeit volle Kontrolle über das System mittels CLI. (Und verdammt, ist das schlank und schnell!!) big_smile

Beitrag geändert von kill -9 (11.02.2014 01:00:20)

Offline

#15 11.02.2014 02:06:32

matthias
Moderator

Re: [Wiki] Überarbeitung der Anleitung für Einsteiger

Du solltest auch aber keine Uralt-Threads heraussuchen. Ich entfixiere das mal, und danach sind auch alle wieder Freunde.

Offline

#16 11.02.2014 02:48:43

kill -9
Mitglied

Re: [Wiki] Überarbeitung der Anleitung für Einsteiger

Oops, und ich dachte, das wäre noch aktuell ^^

Offline

Schnellantwort auf dieses Thema

Schreibe deinen Beitrag und versende ihn
Deine Antwort

Fußzeile des Forums