Как успешно вносить изменения в Ninja

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

Правила оформления кода

Основными являются правила оформления кода Google для C++, с некоторыми дополнениями:

• В прошлом мы часто использовали using namespace std;. Для новых вкладов, пожалуйста, постарайтесь избегать использования этого и вместо него используйте std::, когда это возможно. Однако, пожалуйста, не меняйте существующий код просто чтобы добавить std::, если ваш вклад уже требует изменения этой строки кода.
• Используйте /// для Doxygen (используйте \a для ссылок на аргументы).
• Не обязательно документировать каждый аргумент, особенно когда они явно понятны (например, в CanonicalizePath(string* path, string* err) аргументы должны быть очевидны).

Если вы сомневаетесь относительно форматирования кода, пожалуйста, используйте clang-format. Однако, пожалуйста, не форматируйте код, который не является частью вашего вклада.