Что же такое документация?
Постараюсь с улыбкой на лице ответить на этот вопрос :)
Итак:
Документация
- это то, что все хотят видеть, но никто не хочет за это платить.
- это благодатная почва, из которой, при правильном удобрении, вырастет то, что мы туда посадили.
- это гарантия того, что мы сделали все, что от нас требовали (при условии адекватного её понимания)
- это то, что все ищут, когда понимают, что зашли в тупик.
- это то, чем можно ткнуть в лицо упрямому разработчику (делайте это очень внимательно, и смотрите не ошибитесь, а то он вам ее ткнет обратно).
Плохая документация - это то чем можно в итоге подтереться.
Хорошая документация - это то что не стыдно показать другим и выложить в открытый доступ в интернете.
Хорошая документация может легко стать плохой, если не следить за ней (не поливать 3 раза в день, не вытирать пыль на листиках, не удобрять, не пересаживать в новую землю...)
В дальнейшем попробую дополнить список... Кстати, а что вы можете сказать про документацию?
четверг, 17 сентября 2009 г.
Документация в IT
Подписаться на:
Комментарии к сообщению (Atom)
Сообщения
4 комментария:
Ооооо, сколько хочется всякого сказать на эту тему. Но так кратко, смачно и емко - увольте, не смогу :)
А вот хороший хулиганский ответ на "кто пишет документацию?" - кому надо, тот и пишет... :)
ммммм придерживаюсь мнения что любой документ может быть в двух видах:
1) продукт который нужно продать (клиенту, начальству, соседу...). Это красиво оформленный, вдумчивый толмуд с картинками настолько сложными чтобы пользователю понравилось.
2) информация которая помогает в работе. Формат может быть любой - наборы RFC, wiki, тот же толмуд но с картинками простыми и обновляемыми.
Иногда случается, что такие формы даже вместе встречаются. Я помнится сам даже такие доки готовил. Потому как сам же и работал по ним. ж-)))
Когда внедрялась наша система, мне велено было написать технологию в виде красивых схем с описанием, сравнивая реальную технологию и автоматизированную и рассмотреть перспективы развития.
Главный и основной плюс по этому документу (благодатной почве) - я в этом хорошо разобралась (в технологии), а документ был далее только однажды применен для обучения нового начальника-пользователя ПО
Отправить комментарий