LINKs in Dokumentationen

[Holomino]

Ich hab das in meiner aktiven Zeit als Dokumentöse versucht, zu vermeiden.
So sehr es verlockt, externe Referenzen (die es teilweise sogar besser erklären, als man es selber vermag) hinzuzuziehen, es senkt die Verwendungsfähigkeit einer Doku, weil das Gehopse im Text den Lesefaden unterbricht. Sprich: gut für den Schreiber, schlecht für den Leser.

In den Prerequisites oder bei den Quellangaben ist es durchaus erlaubt. So eine Liste kann man automatisiert erstellen, einbinden und auch prüfen, aber im Text, wie gesagt, ist's der Gau.

[Siro]

Hallo Holomino,
ja, es ist ein Gau, das habe ich aber erst zu spät bemerkt.
Die Pflege der LINKs "innerhalb, verteilt im Dokument" macht wirklich später sehr viel Arbeit.

Siro