Вопросы с меткой [документация]
Вопросы о разработке технической документации
168
вопросов
0
голосов
0
ответов
25
показов
Генерация документации для нескольких проектов
Есть N кол-во репозиториев .NET Core проектов, которые по итогу публикуются в локальный Nuget, таким образом они между друг другом и связаны.
Каким образом можно создать общую документацию для всех ...
0
голосов
1
ответ
90
показов
Определение прототипа
Читал Документация и нашел
JavaScript часто описывают как язык прототипного наследования — каждый объект, имеет объект-прототип, который выступает как шаблон, от которого объект наследует методы и ...
0
голосов
0
ответов
20
показов
Не выгружается документация из репозитория Git lfs
TFS установлен на винде, в этом TFS я создаю пайплайны.
Есть пайплайн в tfs, в пайплайне есть шаг скачивания документации
git clone https://%User%:%Pwd%@tfs.vwewvvf.com/tfs/vwewvvf/Faw/_git/Faw-...
0
голосов
0
ответов
47
показов
Как в C++ подключить Imgui к GTA SAMP sampfuncs
Есть ли документация как подключить ImgUi к C++ для работы на сервере SAMP. Пытался делать сам, вылезает ошибка приложение не является Win32, использовал imgui-directx-9-kiero-hook, как готовый проект,...
0
голосов
0
ответов
15
показов
Help&Manual. В chm не открывается сайт через кнопку Help Windows
Работаю в Help&Manual. В Configuration->Common properties->Help windows задаю кнопке Home ссылку на сайт (условно https://www.google.com). Ссылка без якоря. В chm файле падает ошибка:
...
0
голосов
0
ответов
30
показов
Ошибка asyncApi/generator
После выхода версии v1.10.0 при сборке спецификации начались ошибки
Error: Input is not a corrent AsyncAPI document so it cannot be
processed. at Generator.generateFromString
(/usr/local/share/....
0
голосов
0
ответов
26
показов
Что такое Generator Objects в Python?
Читаю документацию к Python 3.11.2 и нашёл вот такие пункты про Generator Objects. Я примерно понимаю, как работают итераторы и что такое генераторы, но с таким определением сталкиваюсь впервые.
...
0
голосов
0
ответов
20
показов
Как сделать документацию для всего модуля Pyhon?
К примеру, в начале функции можно написать что-то в кавычках и при вызове help на этой функции
К примеру:
def foo():
"Бесполезная функция"
...
help(foo) # Бесполезная функция и ещё доп....
0
голосов
0
ответов
25
показов
Как сослаться на блок документации в соседнем методе DocFx?
Небольшой пример. Условно установлен блок с X_ID содержимое которого хотелось бы использовать в разных местах:
interface Foo {
/// <summary>
/// <para>
/// Описание ...
///...
2
голоса
1
ответ
159
показов
Как правильно писать документацию?
Я видел в кодах на Python3 документацию следующего типа:
"""
Документация
"""
Но также я видел что часто пишут что-то типа:
"""
:name
Test
:...
0
голосов
0
ответов
36
показов
Как собрать md файл без кода но с переменными?
Правильно поставленный вопрос содержит половину ответа.
Прошу не посылать в гугл без конкретных запросов, ибо я уже туда так ходил. (автоматическая генерация догументации/markdown, переменные в ...
0
голосов
0
ответов
23
показа
PySide2extn перестала работать с PySide6
Интерфейс:
from PySide6.QtCore import (QCoreApplication, QDate, QDateTime, QLocale,
QMetaObject, QObject, QPoint, QRect,
QSize, QTime, QUrl, Qt)
from PySide6.QtGui import (QBrush, QColor, ...
0
голосов
0
ответов
26
показов
Как добавить описание к свойствам объекта
Я определил новый тип YSDK, используя этот синтаксис
/**
* @typedef {{
* environment: {
* app: {
* id: string
* },
* browser: {
* lang: ...
0
голосов
0
ответов
39
показов
Как можно указать два пути для одного метода? laravel swagger
Пишу аннотации к api методам.
У меня есть один метод в контроллере, но он используется в двух разных роутах.
То есть: /api/v0/somemethod
И: /api/v1/somemethod
Библиотека для аннотаций:
"...
0
голосов
0
ответов
49
показов
Русский язык в .dox файлах (doxygen)
Ситуация следующая:
Сгенерировал документацию с помощью doxygen. В dconfig прописал в поле INPUT_ENCODING кодировку cp1251 для поддержки кириллических комментариев в коде.
Начал делать титульную ...
0
голосов
1
ответ
112
показов
Где лучше разместить документацию к проекту на github?
Ку.
Сгенерировал документацию для проекта в doxygen, хочу закинуть на github pages. Вопрос: как это сделать логичнее и правильнее?
Создать папку "documentation" в репозитории и пихнуть ...
0
голосов
0
ответов
21
показ
Как из отдельных двух устройств принтера и сканера сделать копировальную машину
Есть желание создать программу, которая превратит отдельные сканер и принтер в копировальную систему. Хотел узнать как программно происходят процессы сканирования документа и его печати, но гугл не ...
2
голоса
0
ответов
26
показов
Как работать с sepolicy в C++?
Не подскажете, где искать документацию по libsepol - библиотеке для работы с sepolicy? Вот только не надо говорить "загугли". Google тут вообще молчит. Официальный сайт selinuxproject.org об ...
1
голос
1
ответ
84
показа
Роль пространства имён Net platform Extensions
В принципе я ориентируюсь на windows разработку. Не получается найти официальное позиционирование по этим пространствам имён. Всё что я смог извлечь из поиска,так это то, что они каким то образом ...
-1
голос
1
ответ
44
показа
Кто нибудь помнит название сайта с собраной документацией по множеству языков?
Когда то наткнулся на несколько ресурсов где были собраны документации по множеству из общеизвестных языках и фреймворках, несколько недель уже не могу его найти при том что тогда попадались и аналоги
...
0
голосов
1
ответ
18
показов
Ошибка на mdn в главе Strict mode
Там написано: "перечисленные в сериализованном объекте", но в примере сериализованного объекта нету.
Со строгим режимом исключение не выбрасывается:
"use strict";
var o = { p: 1, p: 2 };...
2
голоса
0
ответов
202
показа
Когда должен меняться номер редакции/издания программы?
В соответствии с ГОСТ 19.103 в обозначение программного документа включается "номер редакции документа". Например, в обозначении спецификации АААА.00001-02 это номер 02, в обозначении ...
0
голосов
1
ответ
79
показов
Документирование кода метками [закрыт]
Насколько хорошей практикой является документирование кода метками? В каких ситуациях стоит её использовать?
К примеру, если надо акцентировать внимание в алгоритме:
special_case:
if (cond) {
...
...
0
голосов
2
ответа
278
показов
Документирование react-native
Наступило время для документации кода.
Поскольку проект для меня в совершенно новой области и относится к моему не любимому (мое субъективное мнение) javascript и, который включает функциональные ...
1
голос
0
ответов
43
показа
Почему JSDoc не видит локальные комментарии?
В коде ниже генератор документации jsdoc не видит локальные комментарии к функциям и переменным.
document.addEventListener("DOMContentLoaded", function () {
/**
* Конвертирует Rem в Пиксели
...
0
голосов
0
ответов
33
показа
Где в локальной справке Visual Studio, найти WinAPI FileAPI (там дерево глубокое)?
Например FileApi.h (что есть на сайте Microsoft) должен быть и в 2-х ГБ локальной справки (но там только .Net "весь" есть).
Не смотря на то что в оглавлении и указатель, нет нумирации ...
0
голосов
1
ответ
122
показа
Tensorflow. Документация и что учить прежде
Уважаемые программисты. Я новичок в python, вроде как изучил основы, и очень хочу научить ПК самому играть в игры. Хочу использовать q обучение через модуль tensorflow. Но не нашел адекватной ...
2
голоса
2
ответа
74
показа
Как задокументировать, что метод возвращает self?
У меня есть метод в классе, который возвращает self. Я решил задокументировать это, но понял, что не знаю что написать.
Допустим у меня есть класс 'MyCalss' с методом 'MyMethod'
class MyClass:
...
0
голосов
1
ответ
2k
показов
Документация Django скачать [дубликат]
Подскажите пожалуйста, где можно скачать документацию Django (желательно последней версии и на русском)? Искал, находил только очень старые или неполные версии.
0
голосов
0
ответов
24
показа
php framework clevercore
Подскажите, пожалуйста, кто знаком с php-фреймворком clevercore? Где можно найти на него документацию? Гугл не помогает
0
голосов
0
ответов
46
показов
Документация по c++ в gcc [дубликат]
Я хочу начать разрабатывать на C++ под пингвином и вопрос у меня следующий. Где найти мануал по c++ я имею введу не учебники каких то левых людей, а техническую документацию написанную авторами языка ...
0
голосов
0
ответов
46
показов
Не могу понять, как работает передача по ссылке в PHP
В документации PHP есть следующий код на тему "Передача по ссылке".
function foo(&$var) {
$var++;
}
function &bar() {
$a = 5;
return $a;
}
foo(bar());
?>
Абсолютно не ...
1
голос
1
ответ
151
показ
Как сгенерировать HTML страницы документации по XML комментариям?
Как сгенерировать документацию по Xml комментариям?
DocFX, пишут, что может это делать, но не найду мануала как подключать XML документацию к нему, чтобы она автоматически генерировалась в HTML ...
1
голос
1
ответ
92
показа
Где написано про ООП в документации python
Где в документации python находится раздел описывающий все возможности языка в ООП. Так например на большинстве сайтов про абстрактные классы нет ни слова, а они там появились. В документации смог ...
0
голосов
1
ответ
97
показов
Как сгенерировать документацию с помощью doxywizard в отдельном файле?
при генерации документации c помощью doxywizard в папку с библиотекой добавляются 2 папки прямо в проект:
latex/ и html/
Можно ли настроить doxywizard так чтобы он генерировал все нужные ему папки и ...
0
голосов
1
ответ
331
показ
Как в python docstring задать несколько типов получаемых аргументов или возвращаемых значений
столкнулся с такой проблемой: при написании docstring не могу задать несколько типов значений. Например допустим может в качестве аргумента прийти строка, или список строк. Пытаюсь следующие варианты: ...
0
голосов
1
ответ
40
показов
Расположение Исполнители ролей в некоторых версиях 1C
На странице 1С Документооборот
в интерфейсе есть пункт меню Исполнители ролей.
А в моей версии 1С:Документооборот есть только Роли исполнителей
Подскажите как найти Исполнители ролей. (см. также ...
1
голос
0
ответов
36
показов
Как изменить местоположение плашки с версиями на readthedocs?
Пишу документацию к одному проекту, используя mkdocs под встроенной readthedocs темой. Не могу найти способ переместить плашку с версиями в левый нижний угол, в сайдбар. Может кто подскажет?
(То, что ...
0
голосов
1
ответ
235
показов
В React div должен содержать один дочерний элемент?
class Chosen extends React.Component {
render() {
return (
<div>
<select className="Chosen-select" ref={el => this.el = el}>{this.props.children}
</...
-1
голос
1
ответ
2k
показов
Поиск по сайту средствами Python
у меня вопрос касательно поиска на сайтах где есть форма для ввода слова, по которому идёт поиск на сайте.
Есть ли возможность реализовать на Python такую вещь: Пользователь ввёл в консоль слово и ему ...
0
голосов
0
ответов
107
показов
Документирование кода
Передо мной стоит задача вынести все summary комментарии в отдельные файлы в виде документации со своим форматом. Не нашёл либу, которая позволяет это делать именно со своим форматом. Для лучшего ...
0
голосов
0
ответов
29
показов
Является ли в оракл доках Executor executor = anExecutor опечаткой или стандартным сокращением?
Сегодня у нас java. Тема интерфейс Executor. Мы открываем оракл док , а там пишут:
... для всех задач вы можете использовать:
Executor executor = anExecutor;
executor.execute(new RunnableTask1());
...
0
голосов
0
ответов
118
показов
Генератор документации TypeScript .d.ts
Есть file.d.ts с декларациями
Если сделать :
typedoc --mode file --out docs/ . --includeDeclarations --excludeExternals
То не формируются описания внешних типов, которые цепляются в
/// <...
0
голосов
0
ответов
38
показов
JAVA Название аргументов для интерфейсов после компиляции
После компиляции аргументы методов у интерфейса меняют своё название на varN(var1,var2,str1 etc)
Я хочу сделать библиотеку, и что бы при реализации интерфейсов из этой библиотеки, я видел корректные ...
0
голосов
1
ответ
115
показов
Как лучше всего искать информацию для разработки Android приложения? [закрыт]
Несколько месяцев занимаюсь разработкой Android приложений в Androd Studio. Главная проблема заключается в поиске информации. К тому времени, как я найду что-то более менее подходящее, за спиной у ...
0
голосов
1
ответ
135
показов
Подскажите словарь для чтения технической документации по Android разработке
Знание английского у меня на не очень высоком уровне, а документацию читать нужно. Так как слова там применяются в основном относящиеся к разработке, хотелось иметь словарь основных таких английских ...
0
голосов
0
ответов
26
показов
Создание документации к архиву
Подскажите лучший способ для создания документации к моему архиву.
Исходные данные:
есть проект, в котором беспорядочно лежит куча всяких классов (написанных на Java , IDE - IDEA, OS Windows), ...
0
голосов
0
ответов
59
показов
Подскажите нормативные документы по учёту версий ПО
Нужны ГОСТ или инструкции по учёту версий ПО, может быть кто-нибудь знает эти документы?
1
голос
0
ответов
450
показов
Создание документации к функции Python
почти месяц как начал учить питон. Возник вопрос, как писать документацию к функции, чтобы не закидали палками?
def validator(user_input):
"""
This function checks the user input for the ...
1
голос
2
ответа
64
показа
Как изучить фреймворк изнутри?
Товарищи! Как изучить библиотеку или фреймворк, или любой другой законченный проект по исходникам, дабы внедриться в процесс разработки и поддержки? Какие есть способы и методы для быстрого погружения ...