Was bringt mir eine Entwicklerdoku, die der Entwickler nicht sieht weil sie nicht in den Sourcen steht?
... bzw. nicht direkt mit seinen Code-Änderungen aktualisieren kann. (Finde ich übrigens gar nicht ketzerisch!)
Das DocInsight ist schon ein geniales Tool für diesen Zweck. Durch die Regions stören die Kommentare auch kaum. Die Bearbeitung erfolgt sowieso im DocInsight-Editor.
Man kann wohl auch die Kommentare in eine separate Datei auslagern, aber dann funktioniert HelpInsight auch nicht mehr und ein großer Vorteil ist wieder hin. Die eingebettete Doku hat auch den Vorteil, daß sie von anderen leicht nutzbar ist, die kein DocInsight haben.