Как стать автором
Обновить

Как (не) нужно строить базу знаний для проекта с нуля. Часть Первая, утопическая

Блог компании RUVDS.com Анализ и проектирование систем *Управление разработкой *Управление продуктом *Подготовка технической документации *
Tutorial
Всего голосов 30: ↑30 и ↓0 +30
Просмотры 9.2K
Комментарии 5

Комментарии 5

Так как никто не пишет комментарии и не задает вопросы публично, пользуюсь правом первонаха, чтобы извиниться за то, что получилось долго, подробно, еще и две части. Мне хотелось не просто похвастаться, но дать пережить историю, которую я прошел, и сэкономить силы и время тех, кому понадобится однажды строить свою базу знаний — и кто будет достаточно горд, чтобы не пользоваться кейсами всяких Гуглов и руководствами из учебников.

Вместе с второй частью, я покажу как это все сделано в Ноушен, и поделюсь шаблоном-руководством. Без него, картина не на 100 процентов полная. И вместе с тем, мне была необходима обратная связь, чтобы развивать продукт статьи дальше.

Спасибо за то, что репортите грамматические ошибки и пишете замечания в личные сообщения.

Действительно тяжелое чтиво, особенно если ожидаешь совсем другое. А предисловие занимает пол статьи. 
 
База знаний подразумевает сборник рядовых кейсов, как пример типовые проблемы и их быстрое решение. Или не типовых, но опять же их решение. А у вас не база знаний, у вас судя по созданию официальная документация, и не к инструменту или продукту. Это больше похоже на ТЗ стартапа за 2 недели который решает ВСЕ задачи в любой SaaS фирме. 

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

 Возникают конечно еще вопросы, почему не решались проблемы со старой командой, т.е. причины почему она не справлялась уже зная как все работает, а решили все создать с нуля. Это тоже интересно. 

По поводу отсылки как работать с цветами... а вы ее сами читали?  

У вас три типа разделения сделаны одним цветом, выделить это можно лишь в одно - простыня текста. Можно было хотя бы Шаги выделить корпоративным цветом, выделение в тексте сделать.. гм.. Bold? А подразделы просто бОльшим размером кегеля? 

З.Ы. что сделали с редактором для комментариев? Кто эти нелюди?

Таким образом, когда появлялась новая ситуация или правило, её можно было

Это символизирует

А что именно не так с Evernote? В статье несколько раз говорится про то, что он испортился.

Присоединяюсь к вопросу

Только полноправные пользователи могут оставлять комментарии. Войдите, пожалуйста.