Автор решил улучшить документацию Git после написания постов в блоге и зинов. Они сотрудничали с Мари для создания документа "модели данных", объясняющего основные концепции Git, такие как объекты, ссылки и индекс. Автор обновил введения к нескольким man-страницам Git, таким как `git push` и `git pull`. Они поняли, что для выявления проблем в документации необходим более доказательный подход. Автор попросил тестовых читателей в Mastodon предоставить отзывы о существующей документации. Тестовые читатели выявили запутанную терминологию, неясные предложения и несоответствия в документации. Эта обратная связь помогла автору улучшить man-страницы для `git add`, `git checkout`, `git push` и `git pull`. Автор посчитал изменения для `git push` и `git pull` наиболее интересными, включая определения для "upstream branch" (вышестоящая ветка) и "push refspec" (спецификация ссылки для отправки). Участие в разработке Git включало изучение процесса разработки, в том числе использование сервера Discord и GitGitGadget. Они нашли сообщество Git гостеприимным и получили помощь от многих участников. Автор также создал пользовательскую программу просмотра списков Git для навигации по архивам рассылок.
jvns.ca
A data model for Git (and other docs updates)
Create attached notes ...
