Вопросы по теме 'code-documentation'
JSDoc: любой заполнитель для вложенных объектов с аналогичной структурой.
Я пытаюсь задокументировать следующий объект:
let x = {
stopCP: {
enabled: false,
method: "POST",
body: "STOP"
},
startCP: {
enabled: false,
method: "POST",
body: "START"
},...
127 просмотров
schedule
12.03.2022
Редактор документации кода
Я искал приложение для редактирования документации по коду. Я имею в виду не просто инструмент генерации, такой как doxygen, а приложение, которое позволяет мне редактировать документацию и изменять ее непосредственно в коде.
Кто-нибудь знает...
430 просмотров
schedule
12.04.2022
Выборочно подавлять комментарии XML-кода в С#?
Мы поставляем ряд сборок внешним заказчикам, но не все общедоступные API официально поддерживаются. Например, из-за неоптимального выбора дизайна иногда тип должен быть публично представлен из сборки, чтобы остальная часть нашего кода работала, но мы...
1301 просмотров
schedule
26.04.2022
Комментарии по умолчанию Doxygen
можно ли определить что-то вроде макросов в Doxygen?
Я хочу написать комментарий примерно такого содержания:
/**
\return return_self_reference
*/
и Doxygen заменит return_self_reference строкой, определенной мной.
Комментарий,...
37 просмотров
schedule
26.09.2022
ColdFusion и документирование кода, а также инструменты для нескольких команд разработчиков.
Я начинаю довольно большой новый проект с использованием ColdFusion. В этом новом проекте примут участие несколько разработчиков, поэтому документация кода будет иметь ключевое значение.
Еще одна проблема, которую я надеюсь избежать (либо с...
379 просмотров
schedule
09.03.2023
Julia API / Создание документации
Есть ли у Юлии встроенные инструменты для генерации документации из исходников? Что-то вроде доксигена?
Я не смог найти ничего, поддерживаемого изначально, и мне любопытно, действительно ли что-то существует или кто-то может порекомендовать...
739 просмотров
schedule
02.11.2022
Есть ли способ прикрепить комментарий документа Javadoc к сценарию Groovy?
Для класса или метода Groovy или Java я бы обычно включал любую документацию на уровне API в комментарий документа (он же комментарий Javadoc), а не в обычный комментарий. Каков аналогичный способ добавления таких комментариев к сценарию Groovy?...
2063 просмотров
schedule
23.07.2023
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 просмотров
schedule
06.03.2023
Как добавить форматирование, такое как жирный шрифт, курсив, подчеркивание и т. д., в документацию Kotlin (KDoc)
Я нашел страницу Документирование кода Kotlin в официальном Ссылка на Котлин.
Тем не менее, я не мог найти, как выделить определенные части документации, например, выделить их курсивом или жирным шрифтом.
Я новичок в Kotlin, пришел из Java...
2307 просмотров
schedule
17.09.2023
Какова цель логических значений для свойств точки останова (xs, sm, md) в material-ui
Я изо всех сил пытаюсь найти документацию (или результаты путем экспериментов с кодом), для чего нужны логические значения в качестве значений для реквизитов точки останова для компонента сетки в material-ui. Просмотр документации по API-интерфейсу...
1444 просмотров
schedule
10.11.2022
Документация по переопределенному методу
Я работаю с C # и Visual Studio (2015, другие версии не проверял).
У меня проблема с переопределенным методом документации по коду. См. следующий пример
public class BaseClass
{
public BaseClass()
{ }
/// <summary>
///...
207 просмотров
schedule
03.08.2023
Как вы документируете директивы AngularJS?
Существуют ли специальные стандарты или инструменты для документирования директив AngularJS? Мы явно создаем части повторно используемой функциональности, поэтому мы должны быть в состоянии донести их интерфейсы до разработчиков. Я видел пару вещей:...
2000 просмотров
schedule
16.10.2023