Continous Documentation

Transcript

1. Никита Соболев github.com/sobolevn
2. Continous Documentation Repeatable Software Development Process
3. Repeatable Software Development Process • Платим только за закрытые задачи • Маленькие задачи, по одной за раз • Код, трекер и документация - больше ничего https://wemake.services/meta
4. Мы говорим только про внутреннюю техническую документацию
6. Почему программисты не любят писать документацию? • Им за нее не платят • Они могут черпать знания в других источниках • Они и так все знают
7. Они и так все знают • Работают над одной частью системы • Копят знания • Не делятся ими
8. Наше решение Распределять задачи случайным образом
9. Другие источники • Написал в телеге • Подошел - спросил • Где-то в почте было
10. Наше решение Запретить общаться неформально
11. Мне за ... не платят
12. Наше решение Платить!
15. Проверяй, что пишешь! swagger-conformance doc8 swagger-spec-validator flex jsdoc remark-lint eslint-plugin-jsdoc eslint-config-jsdoc-essential flake8-docstrings sphinx mypy flow
16. Hot start • https://github.com/wemake-services/ wemake-vue-template • https://github.com/wemake-services/ wemake-django-template
17. Проблемы • Попробуй продай! • "У вас такое никогда не будет работать" • Взаимодействие с другими командами
18. Вопросы? github.com/sobolevn sobolevn@wemake.services