Перед каждым разработчиком, который более менее ответственно относится к своему делу встаёт вопрос создания документации к своим продуктам. Недокументированный код тяжело не только передовать на сопровождение, но порой тяжело сопровождать и самому. И чем крупнее и сложнее проект - тем острее стоит этот вопрос.
Элегантное решение этой задачи давно есть. Заключается оно в документировании вашего кода непосредственно в исходном коде - в комментариях.
Doxygen одиз из нескольких программных продуктов, который позволяет на основании комментариев кода выполненных по незамысловатым правилам сгенерировать документацию в нескольких форматах.