Программная группа, в которой я сейчас работаю, недавно решила начать документировать нашу кодовую базу. Первоначальный подход, который они использовали, состоял в том, чтобы использовать встроенный тройной слэш /// метод документирования.
Более новая проблема, которую мы начали обнаруживать, заключалась в том, что результатом выполнения этого через doxygen является очень хорошее представление кодовой базы, но для программиста, для которого мы намеревались сделать эту документацию доступной для чтения нашими системными инженерами, которые будут часто приходят к нам с вопросом, что именно делает задание.
Существует ли простой способ документировать наш код, используя метод /// и doxygen таким образом, что, если мы его запустим определенным образом, мы можем сгенерировать документ, который JUST содержит версию документации по системному проектированию без каких-либо дополнительных поток стандартной документации для программистов, которая отпугнет системного парня, такого как методы, переменные-члены и т. д.? Любые альтернативные решения также приветствуются.
Извините, если это немного сбивает с толку относительно того, что мы пытаемся достичь, я могу скорректировать, как поступят ответы.
Спасибо.