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
