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

Программная документация представляет собой письменный текст, сопровождающий компьютерное программное обеспечение. Он объясняет, как работает программное обеспечение, как его установить, как его использовать, а также другие ресурсы для помощи.

4
Предпринимаются ли усилия для создания совместно редактируемой ссылки на HTML / JS / DOM?
W3Schools имеет репутацию неполного, иногда неправильного и занятого рекламой; Тем не менее, при поиске некоторых вещей или ссылки на документацию при ответе на вопрос SO, он по-прежнему является единственным удобным кросс-браузерным ресурсом. Есть и другие ресурсы, такие как Mozilla Developer Network, которая делает все более и более отличную работу по …

2
Документирование языка программирования: Справочное руководство
Мы смотрим на обновленную документацию по всей нашей продуктовой линейке. Часть этого включает справочные руководства для языка программирования, используемого как часть системы. При написании справочного руководства для языка программирования, каков наилучший способ структурировать его для максимального удобства использования для новичков в языке? Какие ключевые аспекты для каждого ключевого слова задокументированы? …

2
Как документировать спецификацию формата файла [закрыто]
Закрыто . Этот вопрос должен быть более сфокусированным . В настоящее время он не принимает ответы. Хотите улучшить этот вопрос? Обновите вопрос, чтобы он был сосредоточен только на одной проблеме, отредактировав этот пост . Закрыто 6 лет назад . Для проекта мне нужно работать с различными типами файлов из некоторых …

6
Как документировать бизнес-правила
Мне интересно, что было бы формальным и наиболее распространенным методом документирования бизнес-правил? Также, как вы документируете спецификации пользовательского интерфейса для артефактов разработки (например, Документирование полей формы и как кнопки ведут себя на форме, информационный текст и т. Д.)

6
Можно ли обосновать создание Документа по разработке программного обеспечения после разработки?
В настоящее время я работаю над окончанием обучения «Разработка программного обеспечения», в рамках которого мне приходится разрабатывать сложное программное обеспечение индивидуально во внешней компании. Все это должно быть сделано структурированным образом, создавая все соответствующие документы. Для этого проекта я выбрал работу со стандартными документами IEEE: Документ о требованиях к программному …

1
Существуют ли какие-либо эмпирические исследования о влиянии комментирования исходного кода на качество программного обеспечения, удобство обслуживания и производительность разработчика? [закрыто]
Закрыто. Этот вопрос не по теме . В настоящее время он не принимает ответы. Хотите улучшить этот вопрос? Обновите вопрос, чтобы он соответствовал теме разработки программного обеспечения стека Exchange. Закрыто 6 лет назад . Я сторонник комментирования исходного кода и документирования программных продуктов. Мой личный опыт и наблюдения показывают, что …


1
Возможна ли разработка итеративной документации и обеспечивает ли она эффективную документацию?
У меня есть проект для университета, который я не начну сразу, но долго размышлял над этим. Я понимаю, что разработка университетских проектов не похожа на индустрию (сейчас я сам стажер), поэтому ситуация, на которую я сейчас укажу, может показаться нелепой разработчикам программного обеспечения. ^^ Сам проект требует, чтобы мы документировали …

4
Как документировать и обучать других «оптимизированному до неузнаваемости» вычислительно интенсивному коду?
Иногда есть 1% кода, который является достаточно интенсивным в вычислительном отношении и требует самого тяжелого вида низкоуровневой оптимизации. Примерами являются обработка видео, обработка изображений и все виды обработки сигналов в целом. Цель состоит в том, чтобы документировать и обучать методам оптимизации, чтобы код не становился неуправляемым и не склонным к …

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

4
Как проекты с открытым исходным кодом могут быть успешными без документации об их дизайне или архитектуре?
Я хочу улучшить свои навыки программирования, изучая известные проекты с открытым исходным кодом, но я нахожу, что легко потеряться, просто прыгнув в их исходный код. Поэтому я решил прочитать их документацию об их дизайне или архитектуре (например, диаграммы UML), чтобы сначала получить общее представление об организации их кода. Однако, к …

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

9
Документация по коду сначала? [закрыто]
Закрыто . Этот вопрос основан на мнении . В настоящее время он не принимает ответы. Хотите улучшить этот вопрос? Обновите вопрос, чтобы ответить на него фактами и цитатами, отредактировав этот пост . Закрыто 2 года назад . Кто-нибудь когда-нибудь пытался создать полную документацию кода, прежде чем писать код? Я думал …

4
Как обнаруживаются недокументированные функции? [закрыто]
Закрыто . Этот вопрос должен быть более сфокусированным . В настоящее время он не принимает ответы. Хотите улучшить этот вопрос? Обновите вопрос, чтобы он был сосредоточен только на одной проблеме, отредактировав этот пост . Закрыто 4 года назад . Мне всегда было интересно, как найти недокументированный / приватный API? Пример …

9
Изучение выигрышей / потерь производительности документации кода
После долгих поисков я не смог ответить на основной вопрос, касающийся предполагаемого известного в мире разработки программного обеспечения: ЧТО ИЗВЕСТНО: Применение строгой политики в отношении надлежащей документации по коду (будь то теги Doxygen, Javadoc или просто обилие комментариев) увеличивает затраты времени на разработку кода. НО: Наличие подробной документации (или даже …

Используя наш сайт, вы подтверждаете, что прочитали и поняли нашу Политику в отношении файлов cookie и Политику конфиденциальности.
Licensed under cc by-sa 3.0 with attribution required.