По-моему это тупо. Вместо этого нужно было сделать:
1) специализированный встроенный редактор, например HTML с просмотром;
2) навигацию от любого элемента кода к странице, открываемой на редактирование в редакторе документации.
Т исходный код бы не замусоривался
И возможностей по редактированию было бы больше: картинки, например, с диаграммами видеть в wysiwyg.