Вопросы с меткой [документация]

Вопросы о разработке технической документации

Фильтрация
Сортировка
Метки
16 голосов
1 ответ
13k показов

Политика конфиденциальности для android приложения (Privacy policy)

Пришло письмо от Google: Hi developers at Starikov Mark, After review, (название приложения), (пакет приложения), has been removed from Google Play due to a policy violation. This app won’...
Марк Стариков's user avatar
15 голосов
2 ответа
1k показов

Как и чем собирать документацию по базе данных?

В наличии БД Oracle. На протяжении примерно 20 лет разные люди поучаствовали в написании большого количества хранимого кода, с нетривиальными решениями и загадочными взаимосвязями. Документации как и ...
Viktorov's user avatar
  • 7,195
13 голосов
4 ответа
5k показов

Где хранить документацию и вспомогательные файлы проекта?

Где хранить документацию и вспомогательные файлы, которые не относятся к коду, например, скриншоты для README.md? По скриншотам нашел два ответа на enSO: How to add screenshot to READMEs in github ...
while1pass's user avatar
  • 2,265
12 голосов
3 ответа
4k показов

Кто составляет ТЗ?

В организации есть аналитик. Он соглашается составить документ с описанием требований от заказчика. Но не хочет писать ТЗ для программиста. Требования к ТЗ - составить таблицу, где будет описаны ...
Alexander Ulmaskulov's user avatar
8 голосов
10 ответов
923 показа

Как вы храните найденные решения? и храните ли вообще? [закрыт]

Допустим, вы несколько дней ломали голову над какой-то задачей. Перерыли весь интернет, спрашивали на форумах, консультировались с техподдержкой. И нашли решение (или костыль). Сохраняете ли на ...
Denis Khvorostin's user avatar
8 голосов
1 ответ
191 показ

XML документация кода с generics

Есть проект на c# с подробной документацией в xml, вот пример документации: /// ... - много-много текста /// <example> /// Классический пример использования: /// <code> ...
test123's user avatar
  • 1,084
8 голосов
1 ответ
107 показов

Как описать документацию для PowerShell командлета на C#?

Не понимаю, откуда берёт документацию Get-Help, и как написать её для своих командлетов.
bearpro's user avatar
  • 742
7 голосов
2 ответа
7k показов

Как писать комментарии к параметрам метода?

В каком виде следует писать комментарии к параметрам метода, чтобы при вызове метода в его подсказке были эти комментарии?
Геннадий Писарев's user avatar
7 голосов
2 ответа
4k показов

В чем вести / генерировать тех. документацию API растущего проекта?

Пишем немаленький проект. Растет число разработчиков, ролей, серверов, протоколов. Хочется иметь четкую, хорошо форматированную документацию, как, например, у Google : ) В чём, и как её лучше вести и ...
Sergiks's user avatar
  • 30.7k
7 голосов
1 ответ
94 показа

Описать не только методы, но и свойства объектов в gitbook

Пишу документацию по lua модулю. В нём фигурирует объект, у которого кроме методов есть ещё и свойства. В свою очередь, плагин theme-api для gitbook позволяет описать только методы. Как, в таком ...
val - disappointed in SE's user avatar
6 голосов
1 ответ
125 показов

Поиск по командам в linux

В играх на source есть очень удобная команда find, которая позволяет искать по всем командам и их описанию. И тут я подумал, а нет ли чего-нибудь подобного под linux?
Vampir's user avatar
  • 192
6 голосов
1 ответ
3k показов

Научиться писать документацию и хорошо комментировать код [закрыт]

Хочу создать свой проект на JavaScript (уже в работе), затем хочу создать для него (хоть и бесплатный) сайт где можно будет им поинтересоваться скачать и т.д. Может размещу на code.google (уже занял ...
Rules's user avatar
  • 4,966
5 голосов
1 ответ
8k показов

Как сделать документацию к функции?

Как сделать документацию к функции? Как автоматически сохранить документацию в файл? Также как получить документацию из какой-либо функции?
user avatar
5 голосов
2 ответа
140 показов

От какого лица и в какой форме писать комментарии в документации на английском?

Допустим, я пишу комментарий к функции для документации. Мне нужно описать что она делает. Форматирование пока опустим. Предположим, это функция загрузки файла с сервера. По-русски я напишу что-то ...
Aktash's user avatar
  • 131
5 голосов
1 ответ
60 показов

Книга по веб-стандартам? [закрыт]

Подскажите, пожалуйста, хочу прочитать или книгу или документацию по веб-стандартам, чтобы я мог аргументировать почему в форме справа кнопка сохранить, а слева отменить(это например) и тд. Что ...
Fitstd's user avatar
  • 793
5 голосов
1 ответ
154 показа

Документация проекта/проектов + связи

Есть несколько проектов, взаимодействующих друг с другом по http api или console api или еще как-нибудь. Грубо говоря, проект состоит из приложений, приложения состоят из компонентов, компоненты ...
Skywave's user avatar
  • 1,927
5 голосов
1 ответ
154 показа

Существует ли общепринятый способ описать в документации сигнатуру фукции/метода?

Допустим есть некая функция, которая сама разбирает список аргументов foo(...){ } Сначала она ожидает агрумент bar, потом неограниченное число пар baz quux foo(bar baz1 quux1 baz2 quux2 baz3 quux3)...
yrHeTateJlb's user avatar
  • 8,062
5 голосов
1 ответ
241 показ

Какие средства подходят для документирования HTML/CSS/JS с запускаемыми примерами?

В вопросе Возможно ли в markdown отобразить произвольне html-код и стили? я узнал, что в markdown нельзя вставлять сниппеты с кодом (то есть не только исходный код, например HTML+CSS, но и результат ...
Боков Глеб's user avatar
5 голосов
1 ответ
479 показов

Наилучший способ добавлять картинки к документации на код

Самый правильный способ добавить документацию к коду - разместить её рядом с кодом. В этом случае, если меняется код, то с высокой вероятностью разработчик не забудет обновить и документацию. А если ...
Andrey Epifantsev's user avatar
4 голоса
6 ответов
4k показов

Написание 3D-игры [закрыт]

Здравствуйте! Я хочу научиться создавать 3D-игры на PC, но ничего об этом не знаю. Помогите, пожалуйста, что мне изучать? Какими программами это реализуется? Также буду рад ссылкам на статьи, мануалы ...
Starling's user avatar
  • 131
4 голоса
1 ответ
3k показов

Как написать хороший README?

Я думаю, каждый видел README-файлы. Хотелось бы получить подробное руководство о том, как написать исключительный README и при этом потратить как можно меньше сил. Что такое "файл README"? Что мне ...
Stas Salangin's user avatar
4 голоса
1 ответ
393 показа

Документация (summary) во внешнем файле

Имеется библиотека. В ней методы, поля (свойства), которые хорошо бы описать, чтобы при использовании Visual Studio высвечивала описание и подсказки для того или иного поля/метода. Я знаю, что можно ...
MrModest's user avatar
  • 1,364
4 голоса
1 ответ
272 показа

Документация проектов C# на нескольких языках в VisualStudio

Необходимо задокументировать весь код в проекте, чтобы при использовании метода, студия подсказывала о нём всё, что только можно. Единственное, что я смог найти для своей ситуации - это XML ...
Mark Khromov's user avatar
4 голоса
3 ответа
2k показов

Посоветуйте сервис генерации документации для Python

Мне понадобилось написать документацию для API, написанного на базе Python (cherrypy). Хотелось бы максимально автоматизировать процесс, например добавить комментарий с тэгом к функции, чтобы сервис ...
Ivan Kramarchuk's user avatar
4 голоса
1 ответ
214 показов

В чем писать документацию сис.админа

Добрый день. До этого администратором не работал. Пришел в фирму, прошлый админ передал пароли и свалил (был приходящий), ни о какой карты сети, документации по сервисам речи нет. Хочется все ...
lion295's user avatar
  • 175
3 голоса
3 ответа
7k показов

Список @идентификаторов , TODO или что это такое?

Я видел что в некоторых исходных кодах JS например JQuery комментируют так: // Define a local copy of jQuery но это просто строка для людей а // TODO: это уже обнаруживается большинством IDE но JS ...
Rules's user avatar
  • 4,966
3 голоса
2 ответа
971 показ

Правильно ли писать в README.md описания методов?

Есть README.md. Как лучше оформить описание методов? Мне кажется, что сейчас неправильно. VerticalHorizontalScrollView I did not find the ScrollView with two scrolls and decided to write it ...
user avatar
3 голоса
2 ответа
364 показа

Форматирование текста в документации к Java методам/классам - отображение дженериков

Дано: Пытаюсь добаваить к описанию класса в конструкции /** * */ строку ArrayList<String> но отображается (как и тут, в цитате): ArrayList Пробовал эти варианты: Экранирование ...
ЮрийСПб's user avatar
  • 69.8k
3 голоса
1 ответ
174 показа

Исходный код в документации

Можно ли в Javadoc указывать ссылку на исходный код классов и методов, чтобы не нужно было каждый раз искать по каталогам нужный файл? Если да, то как это сделать? Вот пример для Python: ...
Кирилл Малышев's user avatar
3 голоса
1 ответ
178 показов

Как правильно писать документацию?

Я видел в кодах на Python3 документацию следующего типа: """ Документация """ Но также я видел что часто пишут что-то типа: """ :name Test :...
wer310's user avatar
  • 45
3 голоса
2 ответа
3k показов

Где расположена официальная документация HTML?

Где взять официальную, легальную документацию об HTML? Я нашел много сайтов, но они, как мне кажется, сторонние и не от самого разработчика
Anon_ch's user avatar
  • 43
3 голоса
1 ответ
3k показов

Общепринятый символ, обозначающий "ссылка ведет на другой сайт"

Пишу документацию к программному продукту. Хочу отделить ссылки, ведущие на другой сайт, от ссылок внутри того же самого. На Википедии есть специальная картинка, обозначающая такие ссылки. Но это ...
Nick Volynkin's user avatar
  • 34.1k
3 голоса
1 ответ
351 показ

Как правильно работать с документацией? (библиотек и самого языка)

Вызубрил теорию. Началась практика. Обнаружилось, что документация к некоторым модулям и библиотекам неимоверно большая. К примеру рассмотрим python, tkinter. Если через help открыть модуль, то ...
  Pogremix's user avatar
3 голоса
2 ответа
1k показов

Документация для open-source проекта

Привет всем! Написал небольшую библиотеку на PHP. Теперь встал вопрос о создании сайта для нее. Сайт я решил делать с использованием Yii Framework. Ну и само собой разумеется, что на сайте должна ...
Dobby007's user avatar
  • 1,395
3 голоса
1 ответ
394 показа

Составление подробной документации о вашей сети

Здравствуйте.Вот решил в кучу собрать свои документы, которых невероятно много: о всех устройствах, да с анализами разными. Т.е. на данный момент у меня имеется гора различных документов, включающих ...
Dex's user avatar
  • 9,981
3 голоса
1 ответ
541 показ

Компонентный паскаль, ищу мануалы

Всем привет Для начала подношу две пиалы чая @Alex Krass за комментарий здесь почему бы не воспользоваться современными решениями: компонентный паскаль и BlackBox Component Builder? Скачал я эту ...
Sh4dow's user avatar
  • 14.3k
3 голоса
2 ответа
950 показов

Создание chm-файлов

Хочу сделать документацию к своей программе. Не документирование кода, а мануал для пользователя. Решил сделать в chm-файле. Не подскажете, как создать такой файл?
Nicolas Chabanovsky's user avatar
3 голоса
1 ответ
1k показов

Генерация документации на основе комментариев в C# коде

Мне нужно внутри моего C# проекта генерировать документацию на основе комментариев в исходниках. Пробовал Doxygen, но он генерирует много мусора в XML (например, сгенерировал XML для class1 и class2, ...
acedened's user avatar
3 голоса
0 ответов
46 показов

Лицензия для документации на ПО под GNU GPL, AGPL?

Есть некое стороннее ПО по лицензией GNU GPL или AGPL. Если писать документацию для разработчиков и вставлять туда участки кода из этого ПО, в качестве примеров, то какие ограничения для данной ...
edem's user avatar
  • 5,970
3 голоса
0 ответов
573 показа

Документирование бизнес-логики и базы данных

Бизнес слой находится в базе в триггерах и процедурах. Задача: Организовать подробное документирование сущностей базы данных а также организовать документирования связанных с этими сущностями бизнес-...
RoulanD's user avatar
  • 301
2 голоса
2 ответа
971 показ

Как вы читаете документацию на английском? [закрыт]

В последнее время, приходится читать много документации на английском. Так как язык я знаю плохо, через раз пользуюсь гугл переводчиком. Метод рабочий, но далеко не самый удобный. Возникла у меня ...
0xSA's user avatar
  • 449
2 голоса
2 ответа
5k показов

Описание формата xlsx и docx

Уважаемый хэшкод, выручай! Не могу найти описание вышеуказанных zip-xml форматов. Несколько понимаю, они стали открытыми и можно формировать соответствующие документы без использования api ms office, ...
pincher1519's user avatar
  • 2,548
2 голоса
2 ответа
92 показа

Как задокументировать, что метод возвращает self?

У меня есть метод в классе, который возвращает self. Я решил задокументировать это, но понял, что не знаю что написать. Допустим у меня есть класс 'MyCalss' с методом 'MyMethod' class MyClass: ...
Ghost's user avatar
  • 351
2 голоса
1 ответ
822 показа

Использование аргументов командной строки

Здравствуйте. Подскажите, пожалуйста, что означают угловые и квадратные скобки, когда я пишу, например, git help? Или вот тут: program < path > [options]
rabbitinspace's user avatar
2 голоса
1 ответ
41 показ

Обозначение нестатического метода

Как следует обозначать в документации нестатический метод класса? Если статический метод можно обозначить как MainClass.main(String[] args), то как быть с нестатическим методом? MainClass::...
Ksenia's user avatar
  • 10.7k
2 голоса
1 ответ
671 показ

Генератор документации для Delphi / Pascal

Подскажите, пожалуйста, какой-нибудь генератор документации (типа Doxygen или Javadoc) для Delphi. Желательно свободный.
northewind's user avatar
2 голоса
1 ответ
80 показов

Есть документация к методам java, как называют описание типов?

Есть документация к методам java и в этой документации есть описание правил какого типа параметры, какой тип возвращаемого значения. К примеру: <R> Stream<R> flatMap(Function<? super T,...
Димончик's user avatar
2 голоса
1 ответ
204 показа

Документирование Delphi [закрыт]

Не подскажите "удобную" систему для документирования исходников Delphi что то вроде doxegena для с
Xramovnic's user avatar
  • 397
2 голоса
1 ответ
800 показов

Возможно ли читать документацию .NET не в Visual Studio (и не в браузере)?

Можно ли скачать полную документацию .NET Framework 4.5 SDK, а также описания языков C# и XAML не используя IDE (Visual Studio) ?
RussCoder's user avatar
  • 3,481
2 голоса
1 ответ
250 показов

Правильная организация процесса разработки ПО

Во многих учебниках, описывающих подходы к разработке программных продуктов, говорится о том, "что" нужно делать и примерно в какой последовательности это нужно делать. Это, конечно же, полезно знать, ...
AseN's user avatar
  • 13.6k