Jump to content

Wiki Strukturierung die 2.


Recommended Posts

So, fangen wir hier nochmal neu mit der Wiki-Diskussion an.

Ausgelöst wurde die Debatte durch eine erfreuliche Initiative im Wiki, konkret auf dieser Seite:

http://www.tinkerunity.org/wiki/index.php/Code-Kitchen

 

Bisher wurde gesagt:

- Wiki zweisprachig

- Entweder mit Sprachauswahl auf Startseite oder wie bei Wikipedia links in der Spalte

- Es kam der Vorschlag, dass jemand aus der Community Wiki-Admin werden könnte, damit der Fortschritt da geordneter ablaufen kann und die TF-Admins damit nicht belastet werden

- Es sollte einen

  -Code

  -Projekte

  -Einsteiger/Erste Fragen

  -Erweiterte Dokumentationen

Bereich geben.

 

 

Habe ich was vergessen?

 

Link to comment
Share on other sites

  • Replies 58
  • Created
  • Last Reply

Top Posters In This Topic

Ok, hier gings jetzt auch weiter:

 

http://www.tinkerunity.org/forum/index.php/topic,409.0.html

 

Mit diesem Beitrag:

 

Habe auch mal eine Seite gepostet. Gibt es die Möglichkeit Code zu posten? Also mit farblichen Markierungen wie es üblich ist?

Wäre für die Übersichtlichkeit auf jeden Fall ratsam!

 

Guckts euch mal an. Wäre glaub ich schöner wenn man je "Tutorial" eine Unterseite macht oder?

 

Link to comment
Share on other sites

Sehr schön.

 

Also auf ein neues. Ich wollte dann nur nochmal auf folgendes hinweisen:

Für das eingesetzte MediaWiki gibt’s Update

 

Un Extensions gibt’s unzählige: hier oder hier.

 

Ich denke es sollten auf jedenfall folgende funktionen gegeben sein:

- Mehrsprachigkeit

- Automatische Kategorisierung

- Code-Highlighting

- Navigation links wie man es bei Wiki's gewohnt ist...

 

Ihr hattet doch teilweise ein paar schöne Beispiel-Wiki's wie bei RaspberryPi usw... nochmal her damit bitte :D

 

Gruß

Christian

Link to comment
Share on other sites

Da fällt mir ein, Christian war glaube ich der vorgeschlagene Wiki-Admin. Den Vorschlag würde ich bei der Gelegenheit gerne mal direkt unterstützen.

 

Wir waren glaube ich auch schon so weit, über konkrete Strukturierungsvorschläg der Main-Page bzw. der ganzen Wiki zu diskutieren. Selbst wenn nicht: Wie wollen wirs machen?

 

Was für Themenbereiche sollten noch vorhanden sein, außer den folgenden:

 

-Code

-Projekte

-Einsteiger/Erste Fragen

-Erweiterte Dokumentationen

 

 

Wenn auf der Startseite nur das jeweils mit einem Kommentar verlinkt ist, dann siehts noch recht leer aus.

 

Wie wäre es noch mit "Tutorials", die über "Erste Schritte" hinaus gehen?

 

 

 

 

Link to comment
Share on other sites

ich würde eher erste Schritte durch Tutorials ersetzen.

Denke die helfen einem mehr. Ist halt die Frage, ob ein Wiki die richtige Wahl für Tutorials ist.

Toll wäre hier auch noch ein Chat bzw. IRC Channel oder so. Wo man direkt mal Leute ohne Beitrag fragen kann. Spart ein Massenaufkommen an unnötigen Einträgen

Link to comment
Share on other sites

Tutorial is doch auch mal net schlecht. Hier könnte man kleine Code-Projekte einstellen, bei denen mehrere Bricks/Bricklets nach und nach angesteuert werden.

 

Man muss das halt von diesen Einstiegshilfen irgendwie abgrenzen.

Wenn wir sagen bei diesen Einsteiger-Seiten hab ich keine fertige Programme die z.B. nur ein Bricklet/Brick ansteuern hab ich kaum einen Mehrwert zur schon vorhandenen Dokumentation...

 

Und Thematische Überschneidungen von Einsteiger-Code & Tutorials sind auch irgendwie blöd...

 

Evtl Könnte man das so machen:

- Code: Hier gibt’s beliebige Programm-Beispiele die jemand mit der Community frei teilen möchte und die er hier beschreibt

- Projekte: Hier werden "ausführlich" Projekte mit (evtl mit Bildern & Videos) Beschrieben und Dokumentiert.

- Einsteiger und FAQ: hier werden evtl spezielle "Einsteiger-Programme", evtl sogar Tutorials und die Allgemeinen Fragen erläutert?!

- Erweiterte Dokumentationen: weiß nicht, ob das nicht sowieso schon in der "Allgemeinen Doku" abgedeckt ist...

 

recht viel mehr fällt mir grad auch net ein.

Link to comment
Share on other sites

würd ich sagen...

Aktuell ists ja sowieso noch nicht wirklich wild, sodass eine Umstellung ja recht fix geht. Und man kann das so nach und nach ja weiter ausbauen. Dazu gibts ja im Wiki auch diese Diskussion-Seiten Funktion.

 

Auserdem isWiki  ja ganz schön weil man immer noch zur alten Version schauen kann und von da Informationen raus ziehen könnte...

 

Die Startseite könnte man auch evtl mit irgend welchen hübschen Grafiken aufwerten. Nur wer hat Lust und kann da was hübsches zaubern?

 

Evlt sollte sich mal ein Admin äußern ob und was für Erweiterungen dem Wiki spendiert werden.

 

Gruß

Christian

Link to comment
Share on other sites

Ich hab mal wieder ein bisschen was in der Code-Kitchen umgestellt .de

 

http://www.tinkerunity.org/wiki/index.php/Category:Code-Kitchen

 

Das mit den Kategorien geht doch... Das wiki is halt nur englisch leider deswegen war ich verwirrt...

 

Damit etwas Kategorisiert wird muss in der Page nur z.B. "[[Category:Java]]" eingefügt werden... dann erscheint es entsprechend. Eine Seite darf ja auch mehrere Kategorien haben...

Beispiel für Java

 

Gruß

Christian

Link to comment
Share on other sites

Wow, im Moment passiert ja echt eine Menge. Und das auch noch recht schnell. So gefällt mir das.

 

Leider verstehe ich in der neuesten Auflage des Wiki nicht den Unterschied zwischen der Code-Kitchen und der Codesammlung.

Wie hattest du das jetzt gemeint? Vielleicht sollten wir die Beschreibung auf der Mainpage anpassen.

 

 

Link to comment
Share on other sites

Mir gefällt auch richtig gut das hier Bewegung reinkommt. Macht weiter so... Denkt aber bitte auch daran, dass wir irgendwie auch ein englischsprachiges Wiki bieten müssen.

 

Ich denke eine komplette Übersetzung des deutschen Teils ist vll. zu viel verlangt. Könnte mir vorstellen, dass eine Verzweigung von der Startseite in den englischen und deutschen Teil sinnvoll ist.

 

Link to comment
Share on other sites

Wo ich grade von einer Englischen Wiki lese, drängt sich mir die Frage auf ob es geplant ist irgendwann die Dokumentationen auf eurer Seite auch in Deutsch an zu bieten? Ich weiß das hat sicher keine große Priorität da wohl jeder der sich mit Programmieren beschäftigt in der Regel auch rudimentäre Englischkenntnisse vorweisen kann. Und viel mehr Englisch ist ja auch nicht nötig. Aber ich fände das schon schön wenn es das auch in Deutsch gäbe. Ansonsten gefällt es mir auch sehr gut wie sich alles entwickelt! Ein dickes Lob an TF und die Jungs im Forum die alles vorantreiben :)

Link to comment
Share on other sites

Da hast du im Grunde schon recht... ich mach mir da morgen Früh nochmal genauer Gedanken wie das sinnvoller wäre.

 

Mit dem deutsch/englisch finden wir bestimmt auch noch was. Da werden ich versuchen mal battis Vorschlag irgendwie umzusetzen :-)

 

Aber etz is erst mal Family Time.

 

Grüße via HP Touchpad...

Link to comment
Share on other sites

ICh würde, wie gesagt, auch dazu tendieren, beide Seiten (Code-Kitchen und Code-Sammlung) zu mergen. Ich würde Die Code-Sammlungsseite als Ausgangspunkt nehmen und die Inhalte der Code-Kitchen oberhalb der Programmiersprachen Subkategorien einfügen.  Hab jetzt einfach schonmal die Verlinkung gemacht und die Links auf der MainPage aufgeräumt.

Falls nochmal jemand auf die alte Code-Kitchen Seite zugreifen möchte:

 

http://www.tinkerunity.org/wiki/index.php/Code-Kitchen

 

Falls das jetzt nicht im Sinne des Mainstreams war, machen wir das wieder rückgängig.

 

Vielleicht sollten wir die Reihenfolge  und die Inhalte auf der Mainpage verändern zu:

 

Erste Schritte

Projekte

Code-Sammlung

Erweiterte Dokumentation

 

Projekte und COde-Sammlung zeigen im Moment auf die gleiche Seite,. Sollen wir das so lassen? Fänd ich nicht schlecht, weil die Inhalte sich überlappen.

 

Link to comment
Share on other sites

So, hab das jetzt einfach auch schonmal umgesetzt. Ist nur ein Strukturierungsvorschlag. Bitte steinigt mich nicht ;-)

Ich finds halt einfacher, wenn man einfach mal was konkretes erstellt und daran dann die konkreten Schwächen ausmachen und entsperchende Verbesserungen vornehmen kann.

 

Habe das jetzt auch nicht sonderlich ausgefeilt gemacht. Es ging mir erstmal nur um die Diskussionsvorlage.

 

 

Direkt mal eigene VErbesserungsvorschläge;

 

- Anstelle der Sprachenlinks oben sollte man vielleicht Bilder einfügen.

- Die sprachliche Ausgestaltung (vor allem im Englischen) sollte verbessert werden

 

 

Wie findet ihr die Strukturierung? Wie können wir es besser machen?

 

Link to comment
Share on other sites

Von der Struktur passt das jetzt alles so mMn, gute Arbeit.

 

Was ich noch verbessern würd: Momentan sieht man in der Codesammlung einfach nur die Unterkategorien, aber nicht, was jeweils in denen zu finden ist. Fänd es ganz gut, wenn das direkt auf der Codesammlung aufgelistet ist, z.B. so:

 

PHP:

  -PHP-Projekt 1

  -PHP-Projekt 2

  -noch ein PHP-Projekt

 

Python:

  -ein Python-Projekt

  -und weils so schön ist: noch eins

 

C#:

  -ja, auch hier wieder was

  -[Anfänger] Erstes C#-Tutorial

usw.

 

 

Ansonsten ist das Layout ja momentan, sagen wir mal, zweckmäßig. Können wir denn da direkt was dran ändern oder ist das vmtl. Adminsache? Selecht Language würde ich z.B. rechts oben positionieren (Seitenübergreifend, also wie bei der normalen Wikipedia), Startseite würd ich (wieder wie Wikipedia, bzw. besser beim Raspberry Pi-Wiki) mit solchen Kästen für die einzelnen Kategorien machen, usw.

Link to comment
Share on other sites

Code Highlighting find ich schon mal gut. Allerdings stimme ich benatweb zu. Ich finde es auch gut wenn man eine Übersicht bekommt. Nur bei vielen Beispielen, die hoffentlich rein kommen, wird es dann vermutlich zu viel.

 

Edit:

etwas in der Art fände ich schöner für die Tutorials. Allerdings haben wir dann vermutlich zu viele Plattformen oder?

http://www.instructables.com/id/Wii-Nunchuck-Adapter/

Link to comment
Share on other sites

Was ich noch verbessern würd: Momentan sieht man in der Codesammlung einfach nur die Unterkategorien, aber nicht, was jeweils in denen zu finden ist. Fänd es ganz gut, wenn das direkt auf der Codesammlung aufgelistet ist, z.B. so:

 

PHP:

  -PHP-Projekt 1

  -PHP-Projekt 2

  -noch ein PHP-Projekt

 

Python:

  -ein Python-Projekt

 

Das sollte mit der Extension: http://www.mediawiki.org/wiki/Extension:CategoryTree machbar sein...

siehe dazu dann auch Wikipedia - Category_tree_all

 

edit: bei der Wikipedia-Verlinkung war a Fehler... hab ich mal korrigiert

Link to comment
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

 Share


×
×
  • Create New...