Vorlage Diskussion:Doku

Beschreibung:	Diese Vorlage dient der Dokumentation von Vorlagen
Parameter:	Beschreibung = Beschreibungstext Parameter = verwendete Parameter
Namensräume:	Vorlage_Diskussion, Vorlage

Brainstorming vom WiMu

Also ich stelle mir das so vor: jede (ja, wirklich jede) Vorlage kriegt auf die Diskussionsseite das Ding da vorne verpasst, und zwar als aller ersten Abschnitt. Die Vorlage funzt je nach Namensraum anners: hier auf der Vorlagen-Diskussionsseite wird die Doku mit den enstprechenden Parametern befüllt, ungefähr so:

{{Doku
| Beschreibung = blahblah-Text
| Kategorie    = z.B. siehe-auch Vorlagen
| Autokats     = z.B. Hat was
| Parameter    = 
parameter1 = macht dieses
parameter2 = macht jenes
| Namensräume  = Liste der Namensräume, in denen die Vorlage verwendet werden sollte
| Beispiel     = irgendein per DPL zuällig ausgewähltes Beispiel
| usw.
}}

In allen anderen Namensräumen lässt sich mit {{Doku|Titel}} per DPL die Dokumentation der Vorlage:Titel anzeigen und im Namensraum Vorlage ohne Angabe des Titels die Doku dieser Vorlage (schlicht {{Doku}}).
Angezeigt soll – bis auf einige obligatorische Parameter – nur das werden, was auch ausgefüllt wurde, bzw. so viel wie möglich per DPL automatisieren (z.B. eben das Anzeigebeispiel); also in etwa so wie bei unserem Kamelionary.
Anwendungsbeispiele der Dokus neben der eigentlichen Dokumentation auf jeder Vorlagenseite

• Fehlerbehebung: zum Beispiel ließen sich die Vorlagen-Kategorien über diese Doku erzeugen, und wenn eben die Angabe der Kat fehlt, erscheint eine Fehlermeldung mit Liste aler Vorlagen-Kategorien (nur ein Beispiel)
• Qualitätssicherung:
  • auf einer zentralen Vorlagen-Qualitätssicherungs-Seite per DPL nach Vorlagen suchen, die sich nicht im angegebenen Namensraum befinden (z.B. Vorlage:Bild auf einer Bild-Diskussionsseite, vermointe Kamelbauten, etc.)
  • man könnte in einem Parameter alle parser-Funktionen angeben, die für die jeweilige Vorlage benötigt werden, und dann nach einem update gezielt nach bugs suchen
• Zentrale Vorlagen-Seite: alle Dokus auf einer zentralen Seite per DPL sammeln, nach Vorlagen-Kategorien sortiert. Allerdings wegen der Übersichtlichkeit und Performance wegen zunächst nur den Vorlagen-Namen und den Parameter Beschreibung. Das restliche Gedöhnse würde ich nicht (wie bisher, glaube ich) mit unserem einklapp- ausklapp- Dingens verstecken, sondern nach klick auf einen butten per ajax von der MediaWiki-API holen. Dann dürften auch 1000 Vorlagen ganz fix geladen werden, und dennoch können wir in die Dokus jede noch so belanglose Info stopfen und DPLqueries machen, wie viele wir wollen.

Beschreibungs-Parameter

kann gerne ergänzt werden:

• Hinweis: verschiedene Hinweis-Texte, durch die durchgeswitcht wird; z.B.: inuse (an der Vorlage wird noch gebaut), veraltet (Vorlage wurde durch eine neuere Vorlage ersetzt), begraben (Vorlage soll begraben werden), etc.
• Beschreibung: eine Beschreibung dessen, was die Vorlage tut
• Kategorie: Kategorie, in die die Vorlage gehört
• Autokats: Kategorien, die mit dieser Vorlage eingebunden werden
• Parameter: Parameter eben, und was die tun
• Namensräume: Liste der Namensräume, in der die Vorlage verwendet wedren sollte
• Beispiel: ein Beispiel eben
• Versionsinfo: Entstehungsdatum, Erstautor, Letzte Bearbeitung, Anzahl der Bearbeitungen, Autorenliste, Größe der Vorlage (in Bytes)
• Seiteninfo: Anzahl der Seiten, die diese Vorlage verwenden (evtl. zufällig zusammengewürfelte Liste mit 10 Beispielseiten)
• Verwendete Dateien: Liste der Bilder, die von der Vorlage verwendet werden
• Verwendete Vorlagen: Liste der Vorlagen, die von der Vorlage verwendet werden.
• Verwendete Funktionen: Liste der Parser-Funktione und Extensions, die verwendet werden.
• Seitenschutzstatus: wer darf editieren?

... mir fällt bestimmt bald noch mehr ein.

Alles in allem, würde ich bei der Gelegenheit mal ganz gerne unsere gesamten Vorlagen-Namensraum entmüllen; z.B. braucht die ollen uralt Quellen&Lizenz-Vorlagen kein Schwein mehr; teilweise haben sich die Vorlagen überholt (z.B. link-Bild); teilweise sind die Dinger mangels unserer tollen, neuen extensions ziemlich gruselig zusammengeschustert, etc. Auch hätte ich mal gerne ein paar verbindliche Programmier-Richtlinien, etwa, dass sich jede Autokat mit jeweils dem gleichen Parameter (z.B.: Kat) deaktivieren lassen muss, usw. So, man sieht: Sommerloch ... mir ist langweilig! Vorschläge und Sempf bitte jetzt. --WiMu 22:52, 4. Jul. 2010 (NNZ)