Wiki-Prinzip: Organisationsübergreifende Querverweise als Regel ergänzt
This commit is contained in:
@@ -517,6 +517,13 @@ Dies gilt für ALLE Dokumentation - nicht nur Netzwerk, sondern auch Host-Dateie
|
||||
|
||||
5. **Tabellen:** Host-/Dienstnamen in Tabellenzellen als Link formatieren.
|
||||
|
||||
6. **Organisationsübergreifende Referenzen** → Hosts/Dienste, die zu einer anderen Kunden-Organisation gehören, werden auf deren Gitea-Repo verlinkt.
|
||||
- **Prinzip:** Die kanonische Doku eines Hosts lebt in der Organisation, zu der er gehört. Andere Organisationen verweisen per Gitea-URL darauf.
|
||||
- Aus Egonetix auf Vinos-Host: `[gw-nu-wan01](https://gitea.egonetix.de/Vinos/infrastructure/src/branch/main/hosts/gw-nu-wan01.md)`
|
||||
- Aus Vinos auf Egonetix-Host: `[srvhost04](https://gitea.egonetix.de/Egonetix/infrastructure/src/branch/main/hosts/srvhost04.md)`
|
||||
- **Lokaler Stub:** Im eigenen Repo kann eine Stub-Datei existieren, die auf die kanonische Doku verweist (z.B. wenn der Host in der eigenen Infrastruktur referenziert wird). Der Stub muss klar als "Gehört zu Organisation X" markiert sein.
|
||||
- **Wann:** Immer wenn ein Host in der Doku einer anderen Organisation auftaucht (VPN-Gegenstellen, gemeinsame Dienste, Abhängigkeiten über Organisationsgrenzen).
|
||||
|
||||
#### Ausnahmen
|
||||
|
||||
- Derselbe Host innerhalb seiner eigenen Dokumentation (kein Self-Link)
|
||||
|
||||
Reference in New Issue
Block a user