Dokumentation in der Organisation

Zweck, Zugänglichkeit und Aufbau der organisationsinternen Wissensbasis in PONTD.

Was sind die Organisations-Docs?

Die Organisations-Docs sind der private Wissensraum deiner Organisation innerhalb von PONTD. Hier sammelt ihr intern alles, was für eure tägliche Arbeit relevant ist – unabhängig von den allgemeinen PONTD-Anleitungen:

Büro- und Projektstandards
Interne Prozesse & Workflows
Rollenbeschreibungen & Verantwortlichkeiten
Vorlagen, Checklisten, projektspezifische Hinweise
Onboarding-Materialien für neue Mitarbeitende

Diese Inhalte sind nur für Mitglieder eurer Organisation sichtbar. Andere PONTD-Nutzer – auch solche aus anderen Organisationen – haben keinen Zugriff.

Zugänglichkeit

Der Zugriff auf die Organisations-Docs ist dreistufig geregelt:

Öffentlich               → kein Zugriff auf Orga-Docs
PONTD-Nutzer             → kein Zugriff (ohne Org-Zugehörigkeit)
Organisations-Mitglied   → vollständiger Lesezugriff
Organisations-Admin      → Lesen + Schreiben + Verwalten

Der Zugriff wird über die Büroeinstellungen gesteuert. Wer die Organisation verlässt, verliert automatisch den Zugriff auf alle Orga-Docs.

Rolle	Lesen	Schreiben	Artikel verwalten
Mitglied	Ja	Nein	Nein
Admin	Ja	Ja	Ja

Warum MDX – kein Vendor-Lock-in

Auch eure Organisations-Docs werden in MDX gespeichert. Das ist eine bewusste Entscheidung gegen Vendor-Lock-in.

Eure Wissensbasis gehört euch – nicht PONTD. Jeder Artikel kann als MDX heruntergeladen, extern gesichert oder in ein anderes System migriert werden. Falls ihr PONTD einmal wechseln solltet, nehmt ihr alle Inhalte vollständig mit.

Eigenschaft	MDX	Proprietäre Formate
Lesbar ohne Software	Ja	Nein
Exportierbar	Ja	Eingeschränkt
In Git versionierbar	Ja	Nein
Plattformunabhängig	Ja	Nein

MDX herunterladen

Jeder Artikel bietet im Editor einen „Als MDX herunterladen"-Button. Die Datei enthält den vollständigen Text inkl. Metadaten:

---
title: "Mein Orga-Artikel"
description: "Interner Standard für XY."
---

## Abschnitt

Euer interner Inhalt hier.

Empfehlungen für die Nutzung

Haltet Artikel kurz und fokussiert – ein Thema pro Artikel
Nutzt klare Titel, die in der Suche auffindbar sind
Strukturiert Inhalte mit H2-Überschriften für bessere Übersicht
Verlinkt verwandte PONTD-How-To-Artikel, wo es sinnvoll ist
Pflegt eine Onboarding-Sektion für neue Mitarbeitende