Das Ziel der Mauerseglerei-Dokumentation innerhalb einer WordPress-Seite ist es eine plattformunabhängige Basis für die Dokumentation von Sachthemen, Arbeitsabläufen, Organisatorischem, etc. zur Verfügung zu stellen. Diese Dokumentation steht zu weiten Teilen nur für eingeloggte Mitglieder zur Verfügung, da sie auch private, vertrauliche, sicherheitskritische und betriebliche Informationen beinhaltet.
Dieser Artikel ist veraltet. An einer Aktualisierung wird gearbeitet. Siehe Konzept (Wissensmanagement)
Entsprechend der Datentypen unterteilen wir (derzeit, 2019) in vier Kategorien:
Doku-Artikel
Hierunter verstehen wir alle Beiträge, die Informationen zu Themen beinhalten, die bis zu einem gewissen Grad unabhängig vom Zeitpunkt ihrer Erstellung gültig sind. Dies sind Beschreibungen, Anleitungen, Geschichten, etc. Dabei versuchen wir darauf zu achten, dass diese Artikel den aktuellen Stand der Dinge festhalten. Eine Historie kann, muss aber nicht geführt werden.
> zur Kategorie
Vorschläge und Beschlüsse
Alle relevanten Entscheidungen, die wir treffen werden schriftlich festgehalten. Üblicherweise werden unsere Entscheidungen im Rahmen soziokratischer Kreistreffen im Konsent beschlossen, es sind jedoch auch andere Verfahren möglich. In Vorbereitung eines Beschlusses wird ein Beschlussvorschlag erstellt, der dann im Falle einer positiven Entscheidung in einen Beschluss umgewandelt wird.
> zur Kategorie
Agenden und Protokolle
Üblicherweise werden wichtige Entscheidungen im Rahmen von Kreistreffen getroffen. Diese, aber auch Ereignisse anderer Art, bei denen festhaltenswerte Informationen ausgetauscht oder generiert werden, werden sorgfältig protokolliert. Bevor solch ein Treffen stattfindet wird üblicherweise eine Agenda aufgesetzt, die im Rahmen des Treffens in ein Protokoll umgewandelt wird.
> zur Kategorie
News
Dies sind Doku-Artikel zu individuellen Ereignissen, die in eine eigene Kategorie gespeichert werden, weil sie von (entsprechend unserer Einschätzung) allgemeinem Interesse sind. Diese Artikel bilden eine Chronologie und werden so verfasst, dass sie ohne zusätzliches Insider-Wissen auskommen.
> zur Kategorie
Einteilung der Doku-Artikel
Vorläufig sind folgende Haupt-Kategorien definiert:
- Leben
- Projekt
- Haus
- Betrieb
- Technik
Umsetzung
In dieser Wissensdatenbank ist jeder Dokumentationseintrag ein WordPress-Blog-Post und damit ein Standard-Objekt innerhalb IT und keine Speziallösung. Dadurch ist sichergestellt, dass die Doku-Einträge für eine für IT-Maßstäbe extrem lange Nutzbarkeitsdauer haben werden. Ferner erleichtert diese Standardlösung die Wartung und das Auffinden von Hilfe im Falle von Problemen.
Natürlich ist eine WordPress-Site kein echtes Wiki, aber die für uns wesentlichen Features lassen sich leicht mit einigen sehr verbreiteten Plugins umsetzen (siehe Wiki basierend auf Posts). Das wichtigste ist hierbei ist, dass wir
- Alle Artikel sorgfältig einer Kategorie zuordnen, sodass sich quasi ein Dateibaum ergibt.
- Alle Artikel Sorgfältig beschlagwortet sind, damit die Suche nach Artikeln effizient ist.
- …
Sicherheit
Es ist wichtig, dass sicherheitsrelevante oder private Informationen nicht öffentlich aufscheinen.
- Über Excerpte, die in Listen, Suchergebnissen, dem News-Feed, etc. angezeigt werden, können Informationen aus dem Passwortgeschützten Bereich herausrutschen.
- Schreibe keine Sensitiven Daten in die ersten 55 (Stand 2019) Worte des Artikels.
- Schreibe selbst ein Excerpt, entweder in einer öffentlichkeitsverträglichen Variante, oder einfach mit den Worten „Informationen werden nicht angezeigt, da diese privat bzw. sicherheitsrelevant sind.“
- Über das Plugin
- Ultimate Category Excluder können Kategorien von der Anzeige im News-Feed kategprisch ausgenommen werden. (derzeit nicht installiert)
- Search Exclude nimmt Artikel aus Suchergebnissen.
Liste der Doku-Artikel
Nachdem die Kategorie „doku“ gelöscht ist gibt der Shortcode display-posts keine ERgebnisse mehr aus.
Zuletzt bearbeitet am 3. Oktober 2024 von Adrian K. (loc.)
