../../Wünsche und Kritik/Navigation und Struktur/erledigt

So, ich hab hier mal die Statements zum Thema Wiki-Struktur gesammelt, damit wir gemeinsam eine bessere Lösung finden können. -- JensDiemer 2006-02-17 07:43:56

Kein Hierwiki

Bitte keine Unterseiten für Sektionen etc. Und auch keine Links zurück im Header. Wir können gerne eine Liste verwandter Seiten über den Tags hinzufügen wie ich das in den letzten Tagen bei einigen Seiten gemacht habe, aber die Links im Header (noch dazu mit [] rund herum) stören gewaltig, wenn man eine Seite ausdrucken will. Und bei der Orientierung helfen sie noch weniger. Dafür ist die Sidebar da. -- ArminRonacher

• Erstens kann man die Sidebar nicht ändern, also wir normaluser. Und wir haben da einige Vorschläge gemacht, was da rein und raus soll.

  Zweitens kann man mit der Sidebar keinen "Fluss" darstellen. Also z.B. beim Tutorial, von wegen "Bitte hier weiterlesen >>>". Also z.B. bei Tutorial/Zahlen der link ganz unten nach Tutorial/Strings. Deswegen finde ich die Links in Form von "Seiten-Name >>>" gut -- JensDiemer 2006-11-23 13:07:31

neue Standpunkte

WSGI Seiten

Irgendwie haben wir hier mehrere Seiten die WSGI erklären. Das große Problem ist allerdings, das der rote Faden fehlt Einen Überblick über alle Seiten zum Thema sollte die Tag-Seiten ausgeben: Tags/Wsgi und evtl. Tags/Web. Wir müßten dringend mal alle Seiten sichten und kräftig neu Strukturieren. Ansonsten haben es Einsteiger wirklich schwer! - JensDiemer

Navigation

JuergenScheuer hat eine Menge umgebaut. Finde ich, JensDiemer, grundsätzlich nicht schlecht. Allerdings hat er quasi neue Navigationselemente eingefüht und ich sehe das als aufforderung zur Diskusstion

Grundsätzlich find ich es gut, wenn der Link "Eine Ebene höher" besser hervorgehoben wird. Ihn allerdings auf jeder Unterwikiseite oben in die Seite per Hand zu setzten, finde ich keine gute Lösung. Ich würde vorschlagen, das man das WikiTheme anpasst, sodas dies automatisch erledigt wird! Außerdem würde ich den Link anders kennzeichnen. Denn die Eckigen Klammern sehen IMHO ähnlich wie die Tags-Links unten aus. Ich bin für "<<< Seiten-Name".

Was IMHO Sinn macht, wenn man unten auf jeder Seite einen weiterführenden Link "Seiten-Name >>>" macht. Das würde Prima im Tutorial funktionieren. Dann könnte man von Tutorial/Listen auf Tutorial/Dictionary verweisen... -- JensDiemer 2006-03-27 05:52:06

<>

• Als Navigationselemente hatte ich auch zuerst diese "<<< >>>" Form (pythonspezifischer). Am Seitenkopf hat mir allerdings die Variante [Link] besser gefallen ;). Für das Tutorial und Verweise mitten im Text finde ich <<< >>> auch gut. Optimal wäre es, wenn man diese Navigationselemente ev. über die Seitenüberschrift setzten könnte (rein optisch...).

• Das mit einem automatischen Theme ist nicht so einfach, denn nicht alle Seiten sind eine Unterseite des vorigen Punktes (z.B. WSGI ist keine Unterseite von Python_im_Web).

• Zur besseren Navigation im Wiki habe ich mir eben überlegt, zentrale Themenschwerpunte auszuwählen und von diesen dann thematisch abwärts zu verweisen. Sozusagen Kapitel im Wiki. Ich hab mal angefangen mit Python im Web und PythonDePlan. Tutorial wäre auch so ein Punkt. So hat man zentrale Anlaufstellen im Wiki, von diesen man entsprechend weitergeleitet wird. Dies ist vor allem auch dann von Vorteil, wenn man von irgendeiner Seite auf eine andere verwiesen wird (Suche, Tags, etc.),weiss man sofort, zu welchem Themenschwerpunkt diese Seite gehört.

• Bei konsequenter Durchführung wäre dann auch so was ähnliches wie eine Wiki-SiteMap möglich. <<< JuergenScheuer 2006-03-27 12:52

  • Ist nicht das was du machst, das selbe wie die Funktion von den Tags??? Seiten Thematisch zusammen zu fassen?

  • Was mir dazu spontan einfällt: Baumstruktur != Wiki-Struktur Wobei ich allerdings auch ehr eine geordnete Baumstruktur besser finden würde!

  • -- JensDiemer 2006-03-27 12:48:53

    • Tags sind gut und wichtig für die grobe Eingrenzung von Seiten, für die Suche etc. Der nicht so geübte Wiki Benutzer allerdings geht normalerweise nicht zuerst zu der Tags Liste, um über die dortige Ergebnisliste zu entsprechenden Wiki Seiten zu kommen. Ich denke, er geht eher über die Wiki Startseite und hangelt sich von dort durch die einzelnen Themen durch, so wie er es von normalen Homepages her kennt. Ein gut zusammengefasster Themenbereich ist so viel besser vom Leser erfassbar. Stell Dir mal vor, das Tutorial würde nur über Tags gehen ...

    • Die Wiki Struktur ist wie sie ist hervorragend. Einfach, flexibel, erweiterungsfähig. Es spricht ja gerade für die Wiki Struktur, dass man, wenn mal will, ein baumähnliches Gebilde oder ein Tutorial mit vor und zurück Buttons basteln kann. Das ganze bedeutet nur Arbeit für diejenigen, die das machen wollen, schadet ja aber auch nicht. Ergänzt durch Tags, Volltextsuche und die Seitenübersicht, ist so ein Wiki dann ein wirklich tolles Nachschlagewerk.

    • -- JuergenScheuer 2006-03-06 16:34

Aufteilung

Ich bin der Meinung, das wir die Seiten Python/Tutorial/FAQ/Artikel und "Tipps und Tricks" anders aufteilen sollten. Die Informationsseite Python und die ersten Punkte der FAQ könnte man zum Auftakt/Einstieg in das Tutorial verschieben. Alle "Tipps und Tricks" sollten separiert werden nach "allgemeine Problemelösungen" (die besser ins Tutorial gehöhren) und "exotischere Problemlösungen" die weiterhin in "Tipps und Tricks" bleiben können. So haben wir etwas Futter für das Tutorial und Einsteiger erhalten eine roten Faden, der im Tutorial drin sein sollte. Das kann so aussehen, das es immer oben auf der Seite einen "zurück"-Link zu finden ist und unter auf jeder Seite ist ein Link "weiter mit Thema XY" so ähnlich wie es bei http://de.wikibooks.org/wiki/Python gemacht wurde. Die beiden Nav.-Links sollten gut sichbar sein! Denn ein Problem ist auch für einen Einsteiger, sich durch ein Tutorial zu bewegen. Liegt natürlich in der Natur eines Wikis, das es quasi keine richtig zentrale Navigation gibt. Vielleicht sollten wir uns die Navigation aus dem Buch A Byte of Python abschauen! Wobei natürlich schnell die Frage aufkommt, warum wir eigentlich ein zweites Buch schreiben sollen??? -- JensDiemer 2006-03-16 13:01:47

alte Diskussion/Statements zum Thema

verschoben von "Wünsche und Kritik"

So wie sie ist, bietet die Navigation weniger Usability als das modern-Theme. Würde also vorschlagen, einfach dieses zu nehmen und ggf. farblich anzupassen.

Was sofort und einfacher optimiert werden kann:

• Punkt Python und FAQ zusammenwerfen. Das was unter Python steht ist, wie man auch an dem Link am Ende sieht, der Anfang einer FAQ.

• AktuelleÄnderungen muss ganz nach oben. Ich muss scrollen, um ranzukommen.

• Allgemeine Begriffe entfernen und von der FAQ aus verlinken.

Tja, das "weiter nach oben" trifft eigentlich dann auch noch auf den Bereich "Seite" zu (ist bei mir auch nur per Scrollen erreichbar), aber das ist ein prinzipielles Problem von rightsidebar-Themes, kann also auch nur durch eine Anordnung a la modern gelöst werden.

• Es gibt schon eine Diskussion zum Thema Struktur unter Diskussion/Übersicht -- JensDiemer 2006-02-16 10:40:04

verschoben von "Diskussion zu Übersicht"

PythonWiki.pdf / Struktur

• Ich hab schon wieder bedenken, dass man die einzelnen "Python-Schätze" im Wiki nicht mehr findet . Die Informationsvielfalt ist natürlich sehr gross und durch das hin un her verlinken geht natürlich die Übersicht ein wenig verloren (...die Tags sind aber schon mal ein gutes Hilfmittel zur Informationsgruppierung...). Ich hätte da mal eine Idee, an der man sich vielleicht entlang hangeln könnte. Angeregt durch das IMHO sehr gute Handbuch Dokumentationsprojekt von www.gentoo.org und www.gentoo.de, bin ich der Meinung, dass das Pythonwiki auch ähnlich einem (Hand-)Buch organisiert werden könnte. Sprich es gibt Einleitung, Allgemeines, Kapitel, Anhänge, Glossar, etc. Aus meiner Erfahrung heraus kann ich sagen, dass die Organisation von Projekten in buchähnlicher Form, also der Zwang zur Dokumentation, sehr gut funktioniert! Vielleicht hilft es uns, wenn wir als Ziel ein automatisch generiertes PythonWiki PDF Handbuch hätten (mit ReportLab, Tiny RML2PDF, etc.) JuergenScheuer.

  • PDF ist grundsätzlich machbar, aber das ist nicht ganz so einfach wie das ganze statisch nach html rendern, wie ich das schon mit dem ubuntuusers wiki mache. Aber ich notier mir das mit dem PDF mal auf. Vielleicht bekommt machs wirklich hin. -- ArminRonacher

    • Ich weiß nicht ob wir ein PDF benötigen, dafür ist das Wiki ja da Allerdings hast du da recht, das eine Struktur wie in einem Buch sehr hilfreich sein könnte... Man müßte halt bei jeder Seite überlegen, wo es in einem Buch einsortiert werden würde... z.B. Könnte gut, die erste Seite Python sein, die zweite Schnellstart, die dritte Module usw. Was fehlt ist quasi der rote Faden, der bei jeder Seite drauf zeigt, wo man weiterlesen könnte... Eine Möglichkeit wäre, wie es viele machen, einfach auf jeder Seite unten einen "weiter zu..."-Link einzufügen -- JensDiemer 2006-01-10 07:29:05

    • Wollte noch erwähnen das es bei wikibooks ein "Buch" zum Thema Python gibt: http://de.wikibooks.org/wiki/Python Es richtet sich aber ehr an Einsteiger. Außerdem tut sich da anscheinend nicht mer sehr viel. Ich hatte da aber vor einiger Zeit mitgeschrieben. Vielleicht macht es Sinn einige Seiten bei uns neu einzupflegen... -- JensDiemer 2006-01-10 07:50:07

• Mir geht's tatsächlich in erster Linie um eine Inhaltsangabe des Wikis wie in einem Buch zur Informationsstrukturierung. Eben der "rote Faden". Der Gedanke, die Inhaltsangabe und den Wiki Inhalt "drucken/rendern" zu können, hilf uns sicherlich beim PythonWiki Aufbau. Ob das ganze dann "tatsächlich" mal in andere "Formate" (html, pdf, rml, etc.) transformiert wird, ist wahrscheinlich eher zweitrangig.JuergenScheuer

  • Vorerst sparen wir das mal aus. Das lässt sich Dank der Tags später evtl automatisch generieren. -- ArminRonacher

• Wir müßen noch ein wenig über die Struktur nachdenken... Ich hab die Seite Wunschliste aus dem alten Wiki übernommen. Wohin kann man die verlinken??? -- JensDiemer 2006-01-25 08:52:40