Am 2011-10-06 18:57, schrieb Pascal Hauck:
> Am Donnerstag, 6. Oktober 2011, 18:12:03 schrieb Dennis Heidsiek:
>> Patrick Strasser ſchrieb am 06.10.2011 17:39 Uhr:
>>> Ist es sinnvoll, das ins Wiki zu übertragen?
>>
>> Nein, die Referenz soll sich ja nicht mehr ändern.

Die Referenz ist ja die Spezifikation.?

> Dennoch könnte man Aspekte, die im Wiki fehlen oder unklar sind, mit Hilfe 
> der 
> Referenz im Wiki berücksichtigen.
> Eine Übertragung 1:1 ins Wiki wäre zwar nicht sinnvoll – die Referenz ist 
> kein 
> Quellcode, folgt aber doch einer gewissen Syntax, die man kennen und 
> verstehen 
> muss. 

Das ist ja eh beschrieben. Direkt ins Wiki kopieren bringt gar nix, da
es es leichter, den Link hinzustellen, das ist in der
Entwicklerübersicht eh ganz oben der Fall.

Was ich erst jetzt kapiert habe ist die Trennung des Wikis in den
Entwickler-Bereich und den Rest. Das meiste steht ja im
Entwickler-Bereich, der Rest hat für mich nicht gereicht, um mir
vollständig sicher zu sein, was welche Taste auf welcher Ebene braucht.

Ich hätte mir eine ausführliche Beschreibung mit hübscher Formatierung
im Benutzer-Bereich vorgestellt, mit ein Verlinkung auf die Seite mit
den Compose und alle erzeugbaren Zeichen. Derzeit liegt das alles
auseinander. Ich hab mir da im Handbuch bei der Beschreibung der Ebenen
echt mehr Inhalt gewünscht. Es wird halt nur stückchenweise klar, was
wie geht.

> Jedoch spricht nichts gegen eine gut lesbare Dokumentation dieser 
> Referenz im Wiki, solange klar ist, dass (1) die Referenz für Neo2 nicht fest 
> ist

Eher umgekehrt, dass die Referenz fest ist und der Inhalt im Wiki eine
Erklärung/Abbildung davon ist, oder? Kann man ja ganz am Anfang dazu
schreiben, dass die wirklich Instanz die Referenz im Repository ist.

> und (2) Treiber sich an der Referenz (und nicht am Wiki) zu orientieren 
> haben.

Ich hätte da ganz klar an User als Zielgruppe gedacht, nicht Entwickler.
Kann man auch noch dazu schreiben, und Entwickler gleich auf die
entsprechenden Seiten leiten. Für mich kann ich sagen: Ich bin Benutzer,
der sich auch für die Vorgänge unter der Haube interessieren, aber als
erstes möchte ich einmal Neo2 ordentlich nutzen können. Alles was zu
weit in die Tiefe geht verfolge ich noch nicht, aber bei Zeiten wäre es
ganz gut einen Pfad zu den Heimstätten der Adepten zu finden.

> Wer aber neu bei Neo ist, 
> wird mit einer gut geschriebenen Wiki‑Seite mehr anfangen können als mit der 
> Referenz.

AOL! +1

Zusammengefasst:

* http://wiki.neo-layout.org/wiki/Tastaturbelegung
  - genaue Beschreibung der Ebenen im Handbuch zugänglich machen
     Entweder direkt eingeflochten oder extra/verlinkt
  - mit Links zu Tote Tasten und Compose versorgen, liegt derzeit
      als Referenz am Ende des Handbuchs, wird aber schnell gebraucht
  - Link auf alle erzeugbare Zeichen einfügen. Ebenfalls Referenz,
      ebenfalls schnell gebraucht.
* Eigene Auflistung für alle Tasten, die kein Zeichen erzeugen. Es ist
  halt aus der Beschriftung der Tasten nicht ersichtlich, ob ein ⇱ ein
  Zeichen U+21F1 erzeugt oder an den Anfang bewegt.

LG

Patrick
-- 
Engineers motto: cheap, good, fast: choose any two
Patrick Strasser <patrick dot strasser at student tugraz dot at>
Student of Telemat_cs_, Graz University of Technology, Austria


Antwort per Email an