summaryrefslogtreecommitdiff
path: root/Wiki/Starship_Factory_Seitenstruktur.mdwn
blob: db2c4cf6d62f7f3c564c2e2c717e5e6bc2f7d955 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
Da es im wiki bereits Anzeichen für Wildwuchs gibt und nicht klar ist, wie
Ordnung geschaffen weden könnte, wird nun **der Versuch unternommen**, hier
eine Übersicht zu erstellen und diese als Dikussionsgrundlage für eine
zukünftige Struktur anzubieten.

(!) Alle im Moment dargestellten Texte sind subjektiv von einer Person
    formuliert. Es ist allerdings jeder dazu aufgerufen, bei diesem
    Ordnungsprozess mitzuwirken oder seine Ideen einzubringen ;)

## Seiten-Struktur

### Blog / Homepage

Die "wichtigste Seite" ist unsere Homepage <http://www.starship-factory.ch>.
Diese ist ein Blog, welches von Mitgliedern verändert und aktualisiert werden
kann. Eine genaue Anleitung dazu fehlt allerdings noch. Knappe Hinweise lassen
sich in [[Howtos/IT-Infrastruktur]] finden. Wenn vom "BLOG" gesprochen wird,
dann ist diese Seite gemeint.

Aufgabe dieser Seite soll sein, auf die Starship Factory aufmerksam zu machen,
Veranstaltungen und Workshops anzukündigen, Teaser zu liefern und auch sonst
unser PR-Sprachrohr zu sein.

### Wiki

Die eigenltichen Infos sind im Wiki (also hier) zu finden. Eine
[[Anleitung|Howtos/Anleitung_Wiki-Formatierung]] gibt es schon. Diese könnte
aber noch verbessert werden. Ziel sollte sein, dass jeder sofort loslegen kann
und falls etwas unklar ist, diese auch sofort selbst auffinden kann, ohne
jemanden fragen zu müssen.

Aufgabe des Wiki sollte sein, unser Equipment aufzuschlüsseln, Anleitungen zu
**allen** Gerätschaften aufzuführen (per QR-Code kann dann an jedem Gerät die
Wiki-Adresse mit weiterführenden Infos und Dokumentation aufgeklebt werden),
Projekte und Workshops zu entwickeln und im weiteren Sinne als Wissensdatenbank
und Nachschlagemöglichkeit dienen.

## Redundanz (=Wiederholung)

Beim Thema Redundanz scheiden sich die Geister :)

Wer den Inhalt des Wiki auswändig kennt, für den sind Wiederholungen blöd. Aber
solche Leute sollten nicht unsere Zielgruppe sein. Selbst wenn man für ein paar
Monate nicht mehr aktiv mitschreibt, dann ist es schwer alle Infos zu finden.
Die Suchfunktion hilft dann auch nicht, weil man eben die Treffer-Begriffe
eines Artikels kennen muss.

**Kurz und kanpp:*** Redundanz ist gut!

Die ikiwiki-Software stellt auch sehr leistungsstarke Direktiven zur Verfügung
(insbesondere [[ikiwiki/directive/inline/]]), um das Ganze zu vereinfachen.
Will sagen: Wir können Informationen auf /!\ kurzen  Seiten darstellen und
diese dann automatisch in andere Seiten einbinden. So muss nicht an zwei
Stellen die Info geändert werden, sondern nur an einer.

## Seitenhierarchien bzw. Ordnung

Das Blog selbst benötigt keine "Unterstruktur". Alle Infos werden historisch
(neustes zuerst) aufgeführt. Wünschenswert wäre aber, dass alle Artikel
weiterführende Links ins Wiki enthalten. Das wäre beim Eintrag
[Laserhackathon](https://www.starship-factory.ch/2016/01/17/laser-hackathon)
eine gute Idee gewesen.

Im Wiki ist bisher begonnen worden, eine Seiten-Hierarchie aufzubauen. Diese
wurde aber nicht durchgehend eingehalten. Hier sollte noch mehr passieren.
Vom Grundsatz her ist ikiwiki in der Lage, Dateien zu verabeiten, die alle in
ein Verzeichnis geklatscht wurden. Besser wäre aber die Verwendung von
Unterordnern.

Der Vorteil von Unterodnern ist, dass diese mit verschienden Filterfunktionen
bzw. Direktiven automatisch weiterbenutzt werden können. Dies würde sehr
helfen, die Ordnung zu verbessern.

Vorschlag für Unterseiten im Wiki:

### Ordner für Informationsseiten

Wir benötigen Ordnung, um die technische Umsetzung des Wiki möglich zu machen,
davon trennen kann man alle Seiten, die den eigentlich Informationsgehalt
(also Content) beinhalten. Die meisten (mitschreibenden bzw. aktiven) Benutzer
werden hauptsächlich hier miteditieren.

* **Benutzer/Xy**:
  Hier können alle Mitglieder eine Kurzbeschreibung von sich hinterlassen.
  Schön wäre, wenn man bei verschiedenen Themen abschätzen könnte, wer hier
  welche Kenntnisse besitzt.  Automatische Übersichtsseite dazu: [[Benutzer]].
  Tagging würde das Ganze auch noch vereinfachen.
* **Howtos/Xy**:
  Hier sollten Anleitungen zu allen Gerätschaften hineinkommen. Momentan sind
  aber solche Beschreibungen teilweise noch beim Equipment zu finden. Das
  sollte einheitlicher gestaltet werden. Sinnvoll wäre auch eine Trennung in
  "Anleitung für xy" und "Reparaturanleitung für xy", wenn es denn nötig sein
  sollte. Automatische Übersichtsseite dazu: [[Howtos]].
* **/Xy**: Automatische Übersichtsseite dazu: [[ ]]
* **/Xy**: Automatische Übersichtsseite dazu: [[ ]]
* **/Xy**: Automatische Übersichtsseite dazu: [[ ]]
* **/Xy**: Automatische Übersichtsseite dazu: [[ ]]

### Ordner für die Wiki-Infrastruktur

Von den eigentlichen Inhaltsseiten sind alle Seiten zu trennen, die das
Drumherum ums Wiki ermöglichen.

* **tags/Xy**:
  Bisher werden nur sehr wenige Tags verwendet. Allerdings zeigen sie teilweise
  auf verschiedene Unterordner. Laut der Hilfeseite [[ikiwiki/directive/tag]]
  sollte aber ein Unterordner tags/ im Urverzeichnis verwendet werden, damit
  die sog, tagbases verwendet werden können. Sinnvolle Tags sind z.B.
  Fähigkeitsbeschreibungen oder Stichworte. Später lassen sich dann sogar
  Tag-Wolken darstellen. Automatische Übersichtsseite dazu: [[tags]].
* **ikiwiki/Xy**:
  Hier sind alle Erläuterungen (auf englisch) zum Wiki zu finden. Leider sind
  diese manchmal nicht ganz eindeutig oder nicht ganz einfach zu verstehen.
  Ausserdem interessiert uns ja eigenltich nicht so sehr, was ikiwi kann,
  sondern, was in unserem Wiki sinnvoll ist. Daher möchte ich vorschlagen, zwar
  den ikiwiki-Ordner beizubehalten, aber alle für uns relevanen Wiki-Infos in
  ein eigenes Verzeichnis zu packen. Dann ist es auch sehr einfach das ganze zu
  filtern.  Siehe auch die automatische Übersichtsseite dazu: [[ikiwiki]].
* **Wiki/Xy**:
  Hier sollten alle Infos zum Wiki hineinkommen, die von den Standard-Seiten
  im ikiwiki-Ordner abweichen oder diese genauer erklären und die für unsere
  Verhältnisse angepassten Informationen enthalten. Automatische
  Übersichtsseite dazu: [[Wiki]].
* **Discussion/Xy**:
  Auf der Wikipedia gibt es zu jeder Seite eine sog. Diskussionsseite. Es soll
  getrennt werden können zwischen der Informationsdarstellung (=die eigentliche
  Artikelseite) und der kontroversen Diskussion über Genauigkeit, Richtigkeit,
  Quellentreue, Relevanz usw. In unserem Wiki gibt es bisher noch gar keine
  Diskussionsseiten. ikiwiki sieht dies aber im Unterordner Discussion bereits
  vor. Automatische Übersichtsseite dazu: [[Discussion]]
* **/Xy**: Automatische Übersichtsseite dazu: [[ ]]
* **/Xy**: Automatische Übersichtsseite dazu: [[ ]]

... stay tuned ... mehr kommt bald...