Technical Standards
Plattform und Workflows für gemeinsames Wissen.
Projektdetails
- Nutzer : Jede/r
- Beispiel 1 : Open Fiber Austria Association, OFAA | docs.ofaa.at | DEMO Link
- Beispiel 2 : yio gmbh (wir) | docs.yio.at
- Umsetzung : Setup, Training und Betrieb
- Technologien : GitHub, Markdown, Python
- Methoden : Redaktion, Struktur, Definition von Rollen und Abläufen, …
- in Betrieb seit : Feb 2022
Beispiel 1: OFAA Knowledge and Standards Platform
Die Entstehung von Dokumenten und Standards ist ein langwieriger Prozess. Das Ergebnis ist schwer zu lesen, Hintergründe und Diskussionen zu einzelnen Standpunkten findet man nur schwer.
Mit unserer ganzheitlichen Lösung, basierend auf Technologien und Methoden der Software-Entwicklung, kann Wissen gemeinsam erstellt und für alle zugänglich genutzt werden. Alle Diskussionen können offen geführt werden, Entscheidungen sind transparent und nachvollziehbar.
Und es sieht auch gut aus. Das von uns eingesetzte Framework entspricht den Erkenntnissen für gute Interfaces, ist sowohl per Browser als auch mobil lesbar, bietet eine Volltextsuche, zahlreiche Möglichkeiten zur Darstellung und unterstützt auch mehrere Sprachen.
Durch das Rollenmodell und redaktionelle Freigaben ist diese Art eine attraktive Alternative zum eher losen Konzept mit Wikis.
Beispiel 2: yio Documentation
Ursprünglich haben wir die Dokumentation gemeinsam in der API hinterlegt. Zahlreiche Fragen gehen aber über die technischen Aspekte der API hinaus. Damit die API schlank bleibt lagern wir nun die Hintergrundinfos und Details zur API in eine eigene Dokumentation aus.