Глубоко ошибается тот, кто думает, что изделиями программистов являются программы, которые он пишет. Программист обязан создавать заслуживающие доверия решения и представлять их в форме убедительных доводов, а текст написанной программы является лишь сопроводительным материалом, к которому эти доказательства применимы.
Э. Дейкстра
Простота требует проектирования и хорошего вкуса.
Л. Торвальдс
Документирование программного обеспечения
Summary
В этом модуле рассматривается один из наиболее важных аспектов напсиания ПО: сопровождение программы адекватной документацией. Этот аспект зачастую умалчиваемается или молчаливо подразумеваемается, как в коммерческих так и в академическиз проектах. Здесь мы постараемся затронуть как общечеловеческие аспекты составления документации так и технические средства, которые могут помочь в оформлении убедительных доводов в пользу применимости решения.Links
- Движение за открытую проектную документацию (А.Шалыто)
- Примеры проектов, сопровождаемые докуменатцией