![[personal profile]](https://www.dreamwidth.org/img/silk/identity/user.png)
Собственно, сабж. В последнее время вопрос весьма актуален.
- как писать документацию?
- как изложить в письменном виде "подразумеваемые правила" (поведения на форуме, например)?
- как излагать best practices? (частный случай той же документации)
- как, вообще, правильно выгружать содержимое своей головы в чужие?
В интерактивном режиме (1:1) у меня плюс-минус получается. Также, получаются всякие примеры и walkthroughs (хз как это адекватно перевести), где структура текста плюс-минус понятна.
Но в общем случае не-интерактивном режиме (документы, уроки) пока что получается плохо, потому что я умею отвечать на вопросы и формулировать вопросы, а формулировать очевидные для себя вещи - не умею.
Что почитать? Как это вообще называется (какие ключевые слова для поисковиков брать)?
- как писать документацию?
- как изложить в письменном виде "подразумеваемые правила" (поведения на форуме, например)?
- как излагать best practices? (частный случай той же документации)
- как, вообще, правильно выгружать содержимое своей головы в чужие?
В интерактивном режиме (1:1) у меня плюс-минус получается. Также, получаются всякие примеры и walkthroughs (хз как это адекватно перевести), где структура текста плюс-минус понятна.
Но в общем случае не-интерактивном режиме (документы, уроки) пока что получается плохо, потому что я умею отвечать на вопросы и формулировать вопросы, а формулировать очевидные для себя вещи - не умею.
Что почитать? Как это вообще называется (какие ключевые слова для поисковиков брать)?