в облаке
Попробовать

Чем DevOps полезен для вашей документации?

Благодаря… как бы это выразиться… крайне гибкому определению DevOps, есть тьма-тьмущая способов разделить и сгруппировать эти практики. К счастью, в сфере документации мы можем применить упрощенный подход, поскольку наш главный продукт - не код, а проза. И снова я посмотрела, что делают у себя сообщества ПО с открытым кодом и команды документации Red Hat, и попытаюсь сейчас разложить «DevOps для документации» на следующие составляющие:

Читать полностью »

Технический писатель в Scrum

Они говорят: переходим на гибкую разработку (Agile). Все будет просто супер. Они, разумеется, не технические писатели.

В настоящее время я уже два года работаю на скрам-команды гибкой разработки в качестве инженера по технической документации (иначе говоря, техническим писателем). За это время я прошла несколько эмоциональных стадий: волнение, уверенность, смятение, разочарование, отчаяние, принятие - и снова уверенность. К этой последней уверенности я пришла, глядя, как мои коллеги по техническому перу начинают свой путь в командах гибкой разработки. В их глазах я вижу те же отчаяние и сомнение, что поразили некогда и меня. И, с сочувствием гладя их по плечу, я осознаю, какой путь я проделала, чтобы прийти к пониманию роли технической информации в гибкой разработке. Не бойтесь, говорю я коллегам. Все не так печально, как кажется. Напротив, скоро вы обнаружите, что все это весьма неплохо работает!

Читать полностью »

Легкое документирование

В Agile проектах мы ценим личное общение. Подобный вид обсуждения требований считается наиболее оптимальным, поскольку при нем можно собрать всю необходимую информацию, как вербальную, так и невербальную. Тем не менее, существуют моменты, когда даже эти слова могут быть неправильно истолкованы или, что более вероятно, плохо сохранены в вашей памяти.

Читать полностью »

Создание справочной документации к продукту

Система управления проектами DEVPROM позволяет разработчикам ПО готовить справочную документацию к программным продуктам без использования дополнительных инструментов, например, Author-It или RoboHelp, предоставляя следующие ключевые возможности:

Читать полностью »

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

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

Читать полностью »