Вопросы по теме 'code-documentation'

JSDoc: любой заполнитель для вложенных объектов с аналогичной структурой.
Я пытаюсь задокументировать следующий объект: let x = { stopCP: { enabled: false, method: "POST", body: "STOP" }, startCP: { enabled: false, method: "POST", body: "START" },...
127 просмотров

Редактор документации кода
Я искал приложение для редактирования документации по коду. Я имею в виду не просто инструмент генерации, такой как doxygen, а приложение, которое позволяет мне редактировать документацию и изменять ее непосредственно в коде. Кто-нибудь знает...
430 просмотров
schedule 12.04.2022

Выборочно подавлять комментарии XML-кода в С#?
Мы поставляем ряд сборок внешним заказчикам, но не все общедоступные API официально поддерживаются. Например, из-за неоптимального выбора дизайна иногда тип должен быть публично представлен из сборки, чтобы остальная часть нашего кода работала, но мы...
1301 просмотров
schedule 26.04.2022

Комментарии по умолчанию Doxygen
можно ли определить что-то вроде макросов в Doxygen? Я хочу написать комментарий примерно такого содержания: /** \return return_self_reference */ и Doxygen заменит return_self_reference строкой, определенной мной. Комментарий,...
37 просмотров

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

Julia API / Создание документации
Есть ли у Юлии встроенные инструменты для генерации документации из исходников? Что-то вроде доксигена? Я не смог найти ничего, поддерживаемого изначально, и мне любопытно, действительно ли что-то существует или кто-то может порекомендовать...
739 просмотров
schedule 02.11.2022

Есть ли способ прикрепить комментарий документа Javadoc к сценарию Groovy?
Для класса или метода Groovy или Java я бы обычно включал любую документацию на уровне API в комментарий документа (он же комментарий Javadoc), а не в обычный комментарий. Каков аналогичный способ добавления таких комментариев к сценарию Groovy?...
2063 просмотров

Doxygen не генерирует автоматические ссылки в блоках кода уценки
Используя doxygen 1.8.13, как я могу получить автоматические ссылки, которые будут генерироваться в коде уценки? Например, у меня есть два следующих файла: test.h /** * Function foo. * This is a code snippet in markdown format: * *...
482 просмотров
schedule 25.05.2023

почему документация Spring Data JPA описывает методы запросов, начиная только с find?
Справочная документация Фреймворк Spring Data JPA описывает методы запросов на примерах. Примером такого метода является findByEmailAddressAndLastname . Начинается с find . Затем они перечисляют все поддерживаемые ключевые слова внутри имен...
391 просмотров

Как добавить форматирование, такое как жирный шрифт, курсив, подчеркивание и т. д., в документацию Kotlin (KDoc)
Я нашел страницу Документирование кода Kotlin в официальном Ссылка на Котлин. Тем не менее, я не мог найти, как выделить определенные части документации, например, выделить их курсивом или жирным шрифтом. Я новичок в Kotlin, пришел из Java...
2307 просмотров

Какова цель логических значений для свойств точки останова (xs, sm, md) в material-ui
Я изо всех сил пытаюсь найти документацию (или результаты путем экспериментов с кодом), для чего нужны логические значения в качестве значений для реквизитов точки останова для компонента сетки в material-ui. Просмотр документации по API-интерфейсу...
1444 просмотров
schedule 10.11.2022

Документация по переопределенному методу
Я работаю с C # и Visual Studio (2015, другие версии не проверял). У меня проблема с переопределенным методом документации по коду. См. следующий пример public class BaseClass { public BaseClass() { } /// <summary> ///...
207 просмотров

Как вы документируете директивы AngularJS?
Существуют ли специальные стандарты или инструменты для документирования директив AngularJS? Мы явно создаем части повторно используемой функциональности, поэтому мы должны быть в состоянии донести их интерфейсы до разработчиков. Я видел пару вещей:...
2000 просмотров
schedule 16.10.2023