Книга: Программист-прагматик. Путь от подмастерья к мастеру
Технические писатели
Технические писатели
До этого момента мы говорили лишь о внутренней документации, той которую составляют сами программисты. Но что происходит, если в вашем проекте участвуют профессиональные технические писатели? Слишком часто программисты просто «перекидывают» материал техническим писателям и дают им возможность заработать себе на жизнь, создавая руководства пользователей, рекламные материалы и т. д.
Это является ошибкой. То, что программисты не составляют такие документы, вовсе не означает, что мы можем поступиться прагматическими принципами. Мы хотим, чтобы писатели восприняли те же основные принципы, что и прагматики, – соблюдали принципы DRY, ортогональности, а также концепцию «модель-визуальное представление», применяли автоматизацию и сценарии.
- Технические аспекты раскрутки во внутреннем пространстве сайта
- 1.2. Основные технические характеристики компьютера
- 13.2.1. Технические основы
- 5.10.2. Платежи за технические услуги
- Нетехнические препятствия
- Писатели
- 15.17.1 Описатели файлов
- Описатели
- Описатели с модификаторами
- 2.2. Основные технические показатели и характеристики УУ
- Технические детали
- Технические параметры баннера