Вопросы с тегом «documentation-generation»

24
Действительно ли BDD доступен для записи непрограммистам?

Разработка, основанная на поведении, с ее символическим синтаксисом сценариев «задано, когда», в последнее время получила широкое распространение из-за его возможного использования в качестве граничного объекта для оценки функциональности программного обеспечения. Я , безусловно , согласен , что...

22
Как мне документировать мой код за минимальное время проверки? [закрыто]

Закрыто . Этот вопрос должен быть более сфокусированным . В настоящее время не принимает ответы. Хотите улучшить этот вопрос? Обновите вопрос, чтобы он был сосредоточен только на одной проблеме, отредактировав этот пост . Закрыто в прошлом году . Я хочу документировать свой код так, чтобы...

20
Дублирование документации по реализации / переопределениям интерфейса хорошо или плохо?

Итак, у нас есть такой интерфейс /// <summary> /// Interface for classes capable of creating foos /// </summary> public interface ICreatesFoo { /// <summary> /// Creates foos /// </summary> void Create(Foo foo); /// <summary> /// Does Bar stuff /// </summary>...

13
Где разместить код документации?

В настоящее время я использую две системы для написания документации кода (я использую C ++): Документация о методах и членах класса добавляется рядом с кодом в формате Doxygen. На сервере Doxygen запускается на источниках, поэтому вывод можно увидеть в веб-браузере Страницы обзора (описывающие...

12
Как документировать экспериментальные или неполные API, такие как @deprecated?

Есть ли хороший термин, который похож, но отличается от «не рекомендуется», чтобы означать, что метод или API находятся в базе кода, но не должны использоваться, потому что их реализация не завершена или, вероятно, изменится? (Да, я знаю, эти методы не должны быть общедоступными, яда, яда, яда. Я...

11
Какие результаты можно предоставить клиенту для веб-приложения? [закрыто]

Закрыто . Этот вопрос должен быть более сфокусированным . В настоящее время он не принимает ответы. Хотите улучшить этот вопрос? Обновите вопрос, чтобы он был сосредоточен только на одной проблеме, отредактировав этот пост . Закрыто 4 года назад . Я закончил веб-приложение, которое в основном...

10
Doxygen поддерживает шаблоны для вывода HTML?

Я задокументировал свой код для doxygen, но я не хочу использовать HTML по умолчанию. Я знаю, что могу настроить его, предоставляя собственные CSS, верхние и нижние колонтитулы и т. Д. (Как это делает GNOME), и как я могу добавить общий PHP-код в файлы и сказать, чтобы он сохранялся как .php, но...