А какие в вашей картине мира вообще бывают документационные артефакты?

Question

Технические писатели

Семён Факторович

А какие в вашей картине мира вообще бывают документационные артефакты?

0

15.10.2023

5 ответов

20 просмотров

Семён Факторович Автор вопроса

Михаил
Да бывают, но их доля значительно меньше упомянуты...

Перечитайте мой вопрос внимательнее, пожалуйста! Какая вообще документация пишется в вашей небольшой компании?

0

15.10.2023

Михаил

Семён Факторович
Перечитайте мой вопрос внимательнее, пожалуйста! ...

Мы же берём абстрактную компанию, пускай будет ряд документов, от пользовательских инструкций и внешних описаний АПИ до внутренних документов работы сервисов и информации о работоспособности системы и используемого стека.

0

15.10.2023

Юра

Чего уж тут скрывать, артефакты в документации были, есть и будут всегда. Ее актуальность, например. Бывает, что мы описываем свои мечты, а не «как есть». Бывает, путаемся в терминологии (например, когда ИИ делают для медицины, я реально путаюсь в медицинских терминах). Бывает, что не учитываем юридические тонкости (например, при заполнении заявок на гранты). Бывает, слишком сложно объясняем и не соответствуем требуемой целевой аудитории. А бывает, что просто бывает… :))

0

15.10.2023

Семён Факторович Автор вопроса

Юра
Чего уж тут скрывать, артефакты в документации был...

«Артефакт» в проектном управлении — это не дефект или недостаток. Это один из вещественных результатов проектной деятельности: код, макет, прототип, документ.

0

16.10.2023

Михаил · Accepted Answer

Михаил

Да бывают, но их доля значительно меньше упомянутых выше. Видимо картину не до конца обрисовал. Речь об относительно небольшой компании находящейся в цикле роста (несколько продуктовых команд).

0

15.10.2023

Похожие чаты

А какие в вашей картине мира вообще бывают документационные артефакты?

5 ответов

Похожие вопросы