Моменты, на которые нужно обратить внимание при реализации ДЗ

Защитное программирование
Идею защитного программирования можно сформулировать следующим образом: «прежде чем делать что-то - проверь, с корректными ли данными ты начинаешь это делать».
Проверка данных из внешних источников.
Проверка данных из внутренних источников.
Выработка правил обработки некорректных входных данных:
Возвращение нейтрального значение.
Выбор ближайшего допустимого значения.
Возвращение кода ошибки.
Запись логов в файл.

Утверждения (asserts)
Утверждения – это код, используемый во время разработки, с помощью которого программа проверяет правильность своего выполнения.
Общие положения по применению утверждений.
Используйте обработку ошибок для ожидаемых событий и утверждения для событий, которые происходить не должны.
Используйте утверждения для документирования и проверки предусловий, постусловий, инвариантов цикла.
Не помещайте выполняемый код в утверждения.

Модульное тестирование (1)
Идея модульного тестирования состоит в том, чтобы писать тесты для каждой нетривиальной функции.
Преимущества
Модульное тестирование облегчает обнаружение и устранение ошибок, позволяет достаточно быстро проверить не привело ли очередное изменение к появлению ошибок в оттестированных местах программы.
Модульное тестирование можно использовать как документирование кода.

Модульное тестирование (2)
Преимущества (продолжение)
Модульное тестирование способствует отделению интерфейса от реализации.
Модульное тестирование поощряет внесение изменений.
Недостатки (мнимые?)
Написание тестов увеличивает срок разработки.
В процессе разработки программы требования могут измениться и придется менять тесты.
«Мои подпрограммы слишком сложно протестировать».

Функциональное тестирование: автоматизация
Функциональное тестирование - это тестирование ПО в целях проверки реализуемости функциональных требований, то есть способности ПО в определённых условиях решать задачи, нужные пользователям. (wikipedia)
Идеи для автоматизации функционального тестирования
перенаправление ввода/вывода;
командные файлы.

Документирование
Концепция грамотного программирования настаивает на включение в текст программы настолько подробных и продуманных комментариев, чтобы она стала исходным текстом не только для исполняемого кода, но и для сопроводительной документации.
Генератор документации - программа или пакет программ, позволяющая получать документацию, предназначенную для программистов и/или для конечных пользователей системы, по особым образом комментированному исходному коду.

Документирование:doxygen
/// Этот комментарий обработается Doxygen
/// Эта строка будет «прилеплена» к предыдущей (и отделена пробелом)
// эта строка будет проигнорирована Doxygen
Для оформления текста внутри комментария используются специальные параметры.
Параметром называется определенное ключевое слово, которое служит для уведомления Doxygen выполнить особую обработку следующего (или следующих) слов комментария.
Чтобы отделить ключевое слово от текста комментария, каждое ключевое слово начинается с ESC-символа.

Документирование: параметры
\brief
Начало краткого описания.
\details
Начало подробного описания.
\param ([dir]) parameter_name description
Описания параметра подпрограммы с именем parameter_name. Необязательный параметр dir, указывает «направление» параметра. Возможные значения [in], [out], [in,out].
\return
Описание возвращаемого значения.