Designrichtlinien im Wiki

[puntarenas]

Der Wikiartikel beschreibt die grundlegenden Designrichtlinien des Wikis und verdeutlicht diese anhand detallierter Beispiele,

Für Diskussionen, Vorschläge und Kritik steht dieser Thread zur Verfügung.

[puntarenas]

Hallo Wikiteam,

meine Vorstellung der Designrichtlinien könnt ihr in der Erstfassung des entsprechenden Beitrags ja nachlesen, ich freue mich auf angeregte Diskussionen (oder ein Machtwort von feltel oder blackm?!).

Vielleicht können wir auch noch einmal einen Jabberchat des Wikiteams einberufen und vielleicht gehe ich den Admins mit meinem Vorschlag eines eigenen Unterforums zur Diskussion der einzelnen Wikiartikel bald derart auf die Nerven, dass sie ein Einsehen haben oder ich endlich aus dem Forum verbannt werde

Gruß
puntarenas

[garibaldi]

Hi Leute;

...und vielleicht gehe ich den Admins mit meinem Vorschlag eines eigenen Unterforums zur Diskussion der einzelnen Wikiartikel bald derart auf die Nerven, dass sie ein Einsehen haben oder ich endlich aus dem Forum verbannt werde

Diskussionsseiten zu den Artikeln fände ich auch sehr gut! Kann man das nicht einfach realisieren, indem man zu Artikel xyz einen Artikel xyz_Diskussion hinzufügt? Wenn die Namensgebung eindeutig ist, muss man dafür ein Unterforum einrichten?

Ich frage als Laie, denn ich habe mich noch niemals mit der Einrichtung einer WikiWikiSoftware beschäftigt, sondern nur mit deren Benutzung.

Grüße, garibaldi

[Incom]

Moin!
Hab die Seite jetzt erstmal nur überflogen, aber was ich unglücklich finde ist dass für Verzeichnisse ein eigener Code Block genommen wird. Die reissen Sachen wie "Und dann geht man in den Order /bla/blubb/ und editiert die Datei xy" ausseinander. Da fänd ich kursivschreibung oä besser.
Ausserdem sollte man vielleicht regeln ob Links bei den Kategorien immer mit WikiWords oder immer mit beschreibenden Sätzen gemacht werden sollen. Ich würde letzteres besser finden da es einfach schicker aussieht und ein WikiWord nur selten den Inhalt eines HowTo's beschreiben kann.

MfG
Incom

[puntarenas]

Die reissen Sachen wie "Und dann geht man in den Order /bla/blubb/ und editiert die Datei xy" ausseinander. Da fänd ich kursivschreibung oä besser.

Ich bin ganz deiner Meinung, da hatte ich nicht zu Ende gedacht. Gemeint waren nur dinge wie

Code: Alles auswählen

cd /udr/local/bin
./firefox

aber das sind ja ohnehin Befehle. Ob wir kursiv nicht jedoch am Besten ganz ausschließen und stattdessen Festbreitenschrift verwenden sollten, müsste IMHO auch noch erörtert werden, da kursiv sich zumindest bei Bitstream und Dejavu in MoinMoin sehr schlecht vom überigen Text abhebt.

Ausserdem sollte man vielleicht regeln ob Links bei den Kategorien immer mit WikiWords oder immer mit beschreibenden Sätzen gemacht werden sollen. Ich würde letzteres besser finden da es einfach schicker aussieht und ein WikiWord nur selten den Inhalt eines HowTo's beschreiben kann.

Wikiwords sind mir auch ein Grauß und für mich das entbehrlichste Wikifeature von allen. Allerdings ist die automatische Verlinkung auch durchaus eine Erleichterung, andererseits finde ich es manchmal nervig, wenn in einem Satz fünfmal zu einem WikiWird verlinkt wird, manuell würde man auch nur das erste Auftauchen verlinken.

[puntarenas]

Ich habe die Designrichtlinien für Datei- und Verzeichnisnamen nun entsprechend korrigiert und Beispiele für Festbreitentext und kursive Darstellung hinzugefügt.

IMHO kann man den Authoren getrost zwischen beiden Varianten die Wahl lassen, wichtig ist nur, dass eine Hervorhebung im Fließtext stattfindet und da fett ebenso wie CAPS LOCK von vielen als aufdringlich empfunden wird, sollte es wohl bei kursiv und Festbreite bleiben?!

Fetttdruck kann bei Warnungen und wichtigen Hinweisen sinnvoll sein, sollten wir dort auch das Warnzeichen /!\ obligatorisch machen?

[puntarenas]

Diskussionsseiten zu den Artikeln fände ich auch sehr gut! Kann man das nicht einfach realisieren, indem man zu Artikel xyz einen Artikel xyz_Diskussion hinzufügt? Wenn die Namensgebung eindeutig ist, muss man dafür ein Unterforum einrichten?

Ich persönlich kann mir nichts unpraktischeres Vorstellen, als Diskussionen über ein Wiki zu führen. Andere Wikisoftware wie Mediawiki bringt jedoch spezielle Unterstützung für Diskussionsseiten zu einzelnen Artikeln mit, was die Sache natürlich in einem anderen Licht erscheinen lässt.

Dass MoinMoin keine Diskussionsseiten unterstützt fällt vermutlich nirgends so wenig ins Gewicht wie bei einem Forenwiki, wir haben ja eine full-featured Diskussionssoftware auf dem Server laufen, da liegt es doch nahe, diese auch für Diskussionen zu nutzen.

[Mr_Snede]

Huppsa, kaum iss man ma ein verlängertes Wochenende wech, so tut sich gleich was.
- Und das ist gut so * thumbs up *

Die Regeln decken sich mit dem was ich für mich angewendet und in den Designrichtlinien zur Migration geschrieben habe.
Bin für eine Regel bzgl Pfadangeben oder Programmnamen: Festbreitenschrift
Kursiv habe ich benutzt, um wichtige Sätze / Wörter hervorzuheben.

Verlinkungen sollten so oft wie möglich über ein Wikiword erfolgen, wo es nicht passt halt eben nicht.

Cu Sebastian

[puntarenas]

Bin für eine Regel bzgl Pfadangeben oder Programmnamen: Festbreitenschrift
Kursiv habe ich benutzt, um wichtige Sätze / Wörter hervorzuheben.

Habe ich mal so eingepflegt.

Verlinkungen sollten so oft wie möglich über ein Wikiword erfolgen, wo es nicht passt halt eben nicht.

Verlinkungen sind nett, keine Frage. Aber WikiWords sind hässlich, soviel steht auch fest. Beiträge die nicht als WikiWord verlinkt sind muss man dann halt an einschlägigen Stellen manuell als Link kennzeichnen, bei mehrfachem Auftreten in einem Absatz eben dann nur beim ersten Mal.

0.02€

Wir sollten auch langsam nochmal über Kategorien sprechen. Wenn ich den Chat richtig in Erinnerung habe, ging die Kategorisierung (also Link unten an der Seite KategorieWhatever) zu Lasten der Performance, oder habe ich da etwas verpeilt?

Also sollen wir ausschließlich manuell kategorisieren oder auch zum Anlegen der Kategorielinks am Seitenende animieren?

Gruß
puntarenas

[Mr_Snede]

zu Kategorien:
Lass uns lieber eins nach dem Anderen machen, also die Designrichtlinien ausarbeiten.
Denn dann können wir jeden Artikel, der uns im Folgenden unter die Finger kommt gleichzeitig auf die Richlinien überprüfen.



In die Richtlinien muss noch auf die einheitliche Anwendung Abkürzungen für Datei/Ordnerangaben eingegangen werden:
Mb / MB / MIB / MIb ...

Da kann ich die Tage einen Vorschlag formulieren, aber dafür muss ich noch ein wenig lesen.

[puntarenas]

Beim Stichwort "Kategorien" geht es mir ja um die Richtlinien, inhaltliche und kosmetische Arbeit am Wiki werde ich ebenfalls erst angehen, wenn grundsätliche Dinge geklärt sind, sonst enden wir irgendwann bei der 20. Generalüberholung

Ich meinte insbesondere, ob wir in die Richtlinien aufnehmen sollten, dass Autoren (nicht Authoren, ich bin lernfähig) beispielsweise in die Fußzeile gleich die Zuordnung eintragen, also etwa

Code: Alles auswählen

KategorieSoftware

, so dass umgekeht der Artikel auch über die Seite KategorieSoftware zu finden ist.

Welche Kategorien im Einzelnen Bestand haben und ob Unterkategorien ebenfalls auf der Seite vermekt werden sollten, können wir immer noch später besprechen.

[Mr_Snede]

Gut dann lass uns doch mal eine handvoll Kategorien auswählen / ausdenken. Und Probieren es aus, wie sich das Konzept bewährt.

Aber langsam befürchte ich wir müssen eine Seite "Designrichlinien light" anlegen, damit niemand abgeschreckt wird

cu Sebastian

[puntarenas]

Aber langsam befürchte ich wir müssen eine Seite "Designrichlinien light" anlegen, damit niemand abgeschreckt wird

Wenn wir nach guter Bürokratenart alles bis ins feinste Detail geregelt haben, dann erkläre ich mich freiwillig bereit, eine Kurzzusammenfassung zu erstellen

Dass alle Neuautoren sich wirklich erst ein eingehendes Studium der Designrichtlinien antun, ist wohl ohnehin utopisch, zumindest solange wir über kein geeignetes Druckmittel (wie Rollkommandos) verfügen. Wenn das Gröbste eingehalten wird, lassen sich die Beiträge hinterher hoffentlich trotzdem recht einfach anpassen.

Ich habe mich jetzt mal an einem Beschreibungstext für die Kategoriefunktion versucht und Designrichtlinien zu KategorieBeispielkategorie zugeordnet. Welche Kategorien insgesamt Bestand haben sollten, stünde wohl langsam zur Diskussion, denn damit steht und fällt ja letzten Endes die Struktur des Wikis.

Oh, btw ... sollte ich irgendwann gezwungen sein, MiB zu schreiben, dann gebe ich meine Forumszulassung zurück!

Gruß
Martin

[Mr_Snede]

Ich finde die Kategorien, die du Aufgeführt hast schon gut so.
Da sich ein Wiki ständig in Bewegung befindet, finde ich es nicht so problematisch nachträglich noch weitere Kategorien einzupflegen.
Eine Kategorie "Neue Seite" oder "noch nicht einsortiert" fände ich für gut für Authoren, die mit unserem Wiki niocht so firm sind, oder wenn noch aussteht, wo die Seite überall auftauchen soll.

Ich bin mir nicht so sicher in wieweit automatisch generierte Seiten wirklich weiterhelfen.
Ich glaube eher manuell aufgestellte Seiten die dann die Struktur unseres Wikis darstellen sprechen ein breiteres Publikum(Leser) an.
Und im Grunde wird es eine Handvoll Artikel/Themenkomplexe geben, die sozusagen das Rückgrat bilden.
Die werden recht einfach manuell zu organisieren sein.

Ich habe nämlich die Erfahrung gemacht, dass viele Leute sich mit einem Wiki auch als Leser schwertun.
Navigationen, die aus der Denkweise der Wikiwelt kommen machen es da schwerer.
Oft verwirren die zusätzlichen Knöpfe/Schaltflächen und Wikispeziallinks mehr als man sich vorstellen mag.
Deshalb habe ich bei meinen Wikis wie wikitypischen Elemente vor dem Leser "verstecken" müssen, um eine Akzeptanzbasis zu schaffen.


Was haben dir denn MiB's getan?

cu Sebastian

[Unki]

Vielleicht wollt Ihr einen Bereich im Wiki einrichten, in dem Sich die Autoren erstmal austoben können? Der Bereich wäre etwas abgetrennt vom normalen Wikibereich. Ob man ihn Sandkasten, Baustelle o.ä nennt, sei dann rauszufinden.

Rainer

[puntarenas]

Ich finde die Kategorien, die du Aufgeführt hast schon gut so.

Sind nur von der momentanen Startseite abgeschrieben, aber im großen ganzen schon ganz nett. Ich habe nur der Eingruppierung des SoftwareFinders unterhalb von Software vorgegriffen, sollte meiner Meinung nach an exponierter Stelle ganz oben auf die Übersichtsseite "Software" kommen.

Da sich ein Wiki ständig in Bewegung befindet, finde ich es nicht so problematisch nachträglich noch weitere Kategorien einzupflegen.

Absolut, nur sollte man eben einen gewissen Wildwuchs eindämmen und neue Kategorien dann eben auch für die anderen Autoren zur Vefügung stellen, das heißt eine Beschreibung der neuen Kategorie erstellen und einpflegen (und möglicherweise eine KategorieSeite, siehe unten)

Eine Kategorie "Neue Seite" oder "noch nicht einsortiert" fände ich für gut für Authoren, die mit unserem Wiki niocht so firm sind, oder wenn noch aussteht, wo die Seite überall auftauchen soll.

100%ACK, nur sollten wir uns noch einen griffigeren Namen einfallen lassen, NeueSeite finde ich nichtssagend (btw, der Punkt "Was bedeutet "aussagekräftiger Name"?" ist noch ungeklärt) und Noch_nicht_einsortierte_Seiten ist etwas holprig.

Ich bin mir nicht so sicher in wieweit automatisch generierte Seiten wirklich weiterhelfen.
Ich glaube eher manuell aufgestellte Seiten die dann die Struktur unseres Wikis darstellen sprechen ein breiteres Publikum(Leser) an.
Und im Grunde wird es eine Handvoll Artikel/Themenkomplexe geben, die sozusagen das Rückgrat bilden.
Die werden recht einfach manuell zu organisieren sein.

Ja, mir war das mit den Kategorieseiten auch noch nicht aufgefallen (ergo habe ich es bisher auch nicht vermisst), erst durch den Hinweis im Chat habe ich das auf meinem DektopMoinMoin mal ausprobiert.

Ob wir das wirklich wollen ist ja IMHO auch noch gar nicht abschließend geklärt, den Beschreibungstext habe ich nur mal erstellt, um den Diskussionsgegenstand zu verdeutlichen. Auch inwieweit es zu Lasten der Serverperformance geht ist noch offen (Hallo feltel und blackm! ), wenn du mal Testweise eine der Kategorieseiten aufrufst, die ihren Inhalt automatisch erzeugen, dann ist das gelegentlich zäh wie Kaugummi.

Was haben dir denn MiB's getan?

Kein Kommentar

Vielleicht wollt Ihr einen Bereich im Wiki einrichten, in dem Sich die Autoren erstmal austoben können? Der Bereich wäre etwas abgetrennt vom normalen Wikibereich. Ob man ihn Sandkasten, Baustelle o.ä nennt, sei dann rauszufinden.

Einen Sandkasten bringt MoinMoin von Haus aus mit, oder meintest du eine ganze Sandkastenkategorie mit Unterseiten und Schnickschnack?

Gruß
puntarenas

Edit: Im Übrigen bin ich der Meinung, dass wir eine Wikisektion im Forum brauchen!

[Unki]

Vielleicht wollt Ihr einen Bereich im Wiki einrichten, in dem Sich die Autoren erstmal austoben können? Der Bereich wäre etwas abgetrennt vom normalen Wikibereich. Ob man ihn Sandkasten, Baustelle o.ä nennt, sei dann rauszufinden.

Einen Sandkasten bringt MoinMoin von Haus aus mit, oder meintest du eine ganze Sandkastenkategorie mit Unterseiten und Schnickschnack?
[/quote]

um ein konkretes Beispiel zu nennen, eine passende Sektion im wiki von uu.de

Rainer

Disclaimer:man möge mir die Verweise auf dieses Wiki verzeihen, als Mod in diesem Wik,i kann ich oft nicht anders ...

[puntarenas]

Disclaimer:man möge mir die Verweise auf dieses Wiki verzeihen, als Mod in diesem Wik,i kann ich oft nicht anders ...

Auf das Wiki dort kannst du zu Recht stolz sein

[Unki]

Disclaimer:man möge mir die Verweise auf dieses Wiki verzeihen, als Mod in diesem Wik,i kann ich oft nicht anders ...

Auf das Wiki dort kannst du zu Recht stolz sein

Mir wird warm ums Herz, ich habs den Kollegen glatt weiter geleitet. Danke

[Mr_Snede]

Disclaimer:man möge mir die Verweise auf dieses Wiki verzeihen, als Mod in diesem Wik,i kann ich oft nicht anders ...

Da wir ganz konspirativ beschlossen haben die Ein oder Andere Idee von euch zu klauen geht das schon in Ordnung

[Unki]

Klaro, warum nicht.
Man kann ja auch zusammenarbeiten Ich hab mich zwar nicht mit Interwiki-Links beschäftigt, aber das ikst sicher das passende Stichwort.

Und ja,ein eigenes Wiki-Subforum hat bewährt. Dadurch wird der Supportbereich nicht so mit rein Wiki-relevanten Themen vollgespammt.

Rainer

[puntarenas]

Moin,

ich habe jetzt mal die Kategorien in den Designrichtlinien auf 4 reduziert und kurze Beschreibungen hinzugefügt:

Grundlagen
Software
Hardware
ExterneWissensquellen

Als fünfte Kategorie käme vielleicht noch soetwas wie "debianforum.de" - "Alles rund ums Forum und Wiki" oder so in Frage für Usertreffen, Spendenlisten, Forumrsregeln, ...

Ich würde gerne hören, inwieweit ihr einverstanden seid. Mein Vorschlag wäre, diese 4 Hauptkategorien nochmal in Unterkategorien zu gliedern (also Grundlagen beispielsweise in "Linux-Grundlagen", Installation von "Debian/ GNU Linux", "Das Debian Paketmanagement", ...) und diese Unterkategorien ebenfalls mit Beschreibungen in der Übersicht einzupflegen.

Wie gesagt, der Artikel Designrichtlinien ist zugegebenermaßen bereits recht umfangreich, ich denke aber, dass wir uns später umso leichter tun werden, wenn wir hier umso ausführlichere Erläuterungen vorgeben, speziell auch was die Strukturierung des Wikis angeht. Für Autoren, die keine Zeit oder Lust haben, ertmal einen halben Roman zu lesen, können wir ja immer noch eine kurze und knackige Zusammenfassung mit den wesentlichen Punkten als "Designrichtlinien light" oder so erstellen.

Drizzt Do'Urden hat jetzt mal eine KategorieBenutzer erstellt, in die sich alle Benutzer mit ihren Benutzerseiten eintragen können. Beim kurzen ansurfen der Seite ist mir mal wieder fast das Gesicht eingeschlafen, ich glaube langsam nicht mehr, dass der Server mit automatisch generierten Kategorieübersichten glücklich wird.

Nun könnte man natürlich argumentieren, dass dieses Feature ohnehin niemand nutzt und daher auch keine Last auf dem Server entsteht, aber dann könnten wir es uns eigentlich auch gleich sparen und uns auf manuelle Pflege der Kategorien im Sinne von Übersichtsseiten beschränken?!

Im Übrigen bin ich der Meinung, dass wir eine Wikisektion im Forum brauchen!

Gruß
puntarenas

[Incom]

Ich würde gerne hören, inwieweit ihr einverstanden seid. Mein Vorschlag wäre, diese 4 Hauptkategorien nochmal in Unterkategorien zu gliedern (also Grundlagen beispielsweise in "Linux-Grundlagen", Installation von "Debian/ GNU Linux", "Das Debian Paketmanagement", ...) und diese Unterkategorien ebenfalls mit Beschreibungen in der Übersicht einzupflegen.

Halte ich nicht so viel von. So viele Artikel zum zb Paketmanagement haben wir nicht. Ausserdem käme dann wieder das Problem auf ob ein Debian-Kernel Packet zu den Linux Grundlagen oder zum Paketmanagemant gehört. Zu sehr unterteilen sollten wirs nicht.

MfG
Incom

[Unki]

Man kann Artikel auch mehreren Kategorien zuordnen. So wäre das Problem IMHO auch gut gelöst.

Rainer

[Mr_Snede]

@ unki
An eine Zusammenarbeit habe ich auch schon gedacht, wollte aber warten, bis wir einen Überblick über unser Wiki haben.
Welche softwaretechnischen Möglichkeiten wir benutzen ist dann zu klären, wenn wir soweit sind.
- Und das kann dauern - vergiss nicht, wir sind debianer und brauchen immer etwas länger bis etwas fertig ist

Kategorien:
Lasst uns ruhig nur wenige nehmen und einfach Erfahrungen sammeln.
In Bezug auf dei aktuelle Serverauslastung können wir auch gut drauf verzichten und Kategorieen erst später testen.
Arbeit und Aufgaben um das Wiki endlich voranzubringen gibt es genug.
Da sind mir Kategorien nicht sio wichtig. Vor allem, da scheinbar keiner damit so richtig gearbeitet hat.