Das deutsche Python-Forum

birkenfeld hat geschrieben:Ich kann deine Gründe sehr gut nachvollziehen, und ich have vor, ein alternatives Stylesheet einzubauen, was das Look-and-Feel der alten Version nachbildet. So hat jeder etwas davon.

Hallo birkenfeld!

Ich bin sprachlos! Vielen Dank und weiter so!

lg
Gerold

Ich muss Gerold in einigen Punkten zustimmen: Ich finde die Farbe der Links im Text (blau auf weiss) relativ kontrastarm. Die Pfeile zum Blaettern in der alten Version sprangen mehr ins Auge als die Verweise jetzt.

Den Pfeil nach oben zum Seitenanfang finde ich ziemlich genial, nachdem ich ihn erstmal entdeckt habe. Ers ist relativ schwer zu erkennen, finde ich.

Die Sidebar finde ich klasse, sowas hat mir bisher gefehlt. Bisher bin ich naemlich sehr oft immer wieder per Browserlink zur Startseite zurueckgekehrt, um das Inhaltsverzeichnis zu sehen oder die Suche zu benutzen...

In der Darstellung der Suchergebnisse tauchen noch ziemlich oft HTML/...-Markups auf... Oh, ich sehe gerade, der Module Index ist jetzt nach Themen sortiert -- sehr gut.

Mmh, an dieser Stelle waere jetzt ein Daumen-Hoch- oder Kniefall-Smiley angebracht.

Mmh, an dieser Stelle waere jetzt ein Daumen-Hoch- oder Kniefall-Smiley angebracht. Smile

MfG EnTeQuAk

Rebecca hat geschrieben:Den Pfeil nach oben zum Seitenanfang finde ich ziemlich genial, nachdem ich ihn erstmal entdeckt habe. Ers ist relativ schwer zu erkennen, finde ich.

Ich hab lokal jetzt eine bessere Lösung, hab aber noch keinen Zugriff auf das neue Repository.

In der Darstellung der Suchergebnisse tauchen noch ziemlich oft HTML/...-Markups auf... Oh, ich sehe gerade, der Module Index ist jetzt nach Themen sortiert -- sehr gut.

Das mit dem HTML Markup in der Javascript Suche ist neu. Das ist mir auch schon aufgefallen. Schau ich mir gleich an, der Suchindex wird nämlich wohl auch für die Python Suche verwendet werden.

Rebecca hat geschrieben:Den Pfeil nach oben zum Seitenanfang finde ich ziemlich genial, nachdem ich ihn erstmal entdeckt habe. Ers ist relativ schwer zu erkennen, finde ich.

Ja er ist zwar lustig (hab ihn auch erst gesehen, als hier darauf hingewiesen wurde), aber igendwie habe ich nie den Sinn von Go-To-Top-Links nicht gesehen. Ganz oben komme ich mit ``1G``.. nein, stopp, mit ``Bild Hoch`` Habe ich bisher aber auch noch nicht so besonders oft gebraucht, Typeahead-Suche finde ich wesentlich praktischer.

Jetzt gibts auch die "interaktive" Version zum Testen: http://pydoc.gbrandl.de:3000/

Kurzzusammenfassung: rät URLs (ähnlich wie bei php.net), hat Kommentare, man kann mal testweise die Sidebar nach rechts bugsieren, Feeds, Antispam und ein Adminpanel unter http://pydoc.gbrandl.de:3000/admin/

Zugangsdaten sind testuser:password

Viel Spaß beim Testen

Willst du mal nen Anker setzen, dass unter "Moderate Comments -> View" gleich hinuter zu dem/den Comments gesprungen wird?

Insgesamt: Gute Arbeit! Etwas gewöhnungsbedürftig, aber das ist bei Änderungen ja nunmal oft so.

Ein paar Dinge, die mir so auffallen:

- Die Beschreibungen zu den Hauptlinks der Startseite überschneiden sich an einigen Stellen mit dem Titel darüber, was es schlechter lesbar macht. Da könnte ein leicht größerer Abstand einiges bewirken.

- Auch wenn es nett einheitlich aussieht: Die Klammern sind überflüssig und der Verzicht auf diese trägt ebenfalls zu besserer Lesbarkeit bei. Eine Option wäre zur Not, die Klammern per CSS mit :before und :after hinzuzufügen, damit man sie zumindest für sich selbst deaktivieren kann.

- Ich persönlich benutze den "Global Module Index" *sehr* viel. Der ist mir fast ein bisschen zu weit unten, auch wenn ich mit einem schlanken Browserfenster noch nicht scrollen muss. Fraglich, wie weit die (durchaus sinnvolle) Gruppierung so ideal ist, aber sowas wie "Macintosh Library Modules" und "Distributing/Documenting Python Modules" ist IMHO etwas, das man sicherlich weitaus seltener liest als den GMI - und deswegen ist hier die Reihenfolge für mich sehr suboptimal. Zum Vergleich: Ich benutze sehr viel die .chm-Doku (auch unter Linux; Index und Suchfunktion sind doch irgendwie praktischer als über einen Webbrowser) und dort (wie auch im Web) kommt der GMI an sehr früher Stelle - zu Recht. Bitte das nochmal überdenken.

- Warum müssen die Feeds unbedingt RSS sein? ATOM 1.0 ist der (einzige?) abgesegnete, saubere Standard und jeder halbwegs brauchbare Client kann es ebenso lesen. RSS ist nur ein inkompatibler Formatdschungel mit zahlreichen Problemen, die ATOM löst. Die gängigen ATOM vs. RSS-Vergleiche sollten bekannt oder ansonsten leicht auffindbar sein.

Y0Gi hat geschrieben: - Die Beschreibungen zu den Hauptlinks der Startseite überschneiden sich an einigen Stellen mit dem Titel darüber, was es schlechter lesbar macht. Da könnte ein leicht größerer Abstand einiges bewirken.

Hast du da einen Screenshot dazu? Hier passt das nämlich.

- Auch wenn es nett einheitlich aussieht: Die Klammern sind überflüssig und der Verzicht auf diese trägt ebenfalls zu besserer Lesbarkeit bei. Eine Option wäre zur Not, die Klammern per CSS mit :before und :after hinzuzufügen, damit man sie zumindest für sich selbst deaktivieren kann.

Welche Klammern?

- Ich persönlich benutze den "Global Module Index" *sehr* viel. Der ist mir fast ein bisschen zu weit unten, auch wenn ich mit einem schlanken Browserfenster noch nicht scrollen muss. Fraglich, wie weit die (durchaus sinnvolle) Gruppierung so ideal ist, aber sowas wie "Macintosh Library Modules" und "Distributing/Documenting Python Modules" ist IMHO etwas, das man sicherlich weitaus seltener liest als den GMI - und deswegen ist hier die Reihenfolge für mich sehr suboptimal. Zum Vergleich: Ich benutze sehr viel die .chm-Doku (auch unter Linux; Index und Suchfunktion sind doch irgendwie praktischer als über einen Webbrowser) und dort (wie auch im Web) kommt der GMI an sehr früher Stelle - zu Recht. Bitte das nochmal überdenken.

GMI kann man sicher raufbewegen, ist aber zusätzlich auch in der Topbar oben rechts. CHM müssen wir uns auch noch was einfallen lassen.

- Warum müssen die Feeds unbedingt RSS sein? ATOM 1.0 ist der (einzige?) abgesegnete, saubere Standard und jeder halbwegs brauchbare Client kann es ebenso lesen. RSS ist nur ein inkompatibler Formatdschungel mit zahlreichen Problemen, die ATOM löst. Die gängigen ATOM vs. RSS-Vergleiche sollten bekannt oder ansonsten leicht auffindbar sein.

Das ist ganz einfach. RSS ist schnell implementiert, wird von jedem Client unterstützt, funktioniert auch ohne DTD oder xmlns. Ich sehe ein, dass RSS ein scheiß Format ist, aber für so einfach Feeds ist es ideal.

Guckst du:

Y0Gi hat geschrieben:Fraglich, wie weit die (durchaus sinnvolle) Gruppierung so ideal ist, aber sowas wie "Macintosh Library Modules" und "Distributing/Documenting Python Modules" ist IMHO etwas, das man sicherlich weitaus seltener liest als den GMI - und deswegen ist hier die Reihenfolge für mich sehr suboptimal.

Ich benutze im GMI immer die Type-ahead-Suche oder setze mir gleich ein Bookmark mit Formattern (%s) im Browser, das funktioniert sehr gut.

Also erst mal ich finds genial das sich das was tut, weil die aktuelle Dokumentation ist alles Andere als zeitgemäß.

Ich find aber die Alte auch leichter zu lesen, wobei man das sicher durch anpassen der Farben Schriften änder kann.

Wichtig für ne neue Doku find ich:

• Gute Kommentarfunktion weil man so relativ schnell vile Code-Beispiele bekommt
  Möglichkeit der Übersetzung in ander Sprachen damit die möglichkeit besteht die Doku wenigstens Teilweiße in ander Sprachen zu übersetzen
  Vieleicht noch Quellcode-Ansicht der einzelnen Module

Ich hoffe das Feedback hilft n bisl.
Und danke da ihr das anpackt.

pythonist

pythonist hat geschrieben:

• Vieleicht noch Quellcode-Ansicht der einzelnen Module

Das würde ich allerdings auch super finden!

Sehr gut, gefällt mir!

Ist es normal das die Suche noch (?) nicht geht?

bsp:
http://docs.python.org/dev/search.html? ... a=whatsnew

jens hat geschrieben:Ist es normal das die Suche noch (?) nicht geht?

bsp:
http://docs.python.org/dev/search.html? ... a=whatsnew

Bei mir klappt dein Link.
Die Suchergebnisse kommen aber erst nach, da IIRC, die Suche in Javascript geschrieben ist.

Ah, jo... NoScript

IMHO gehört da ein <noscript>Please enable Javascript</noscript> o.ä. hin