A data model for Git (and other docs updates) https://jvns.ca/blog/2026/01/08/a-data-model-for-git/

[gnomon@mastodon.social]

@b0rk thank you for doing this work. ❤️

[km@mastodon.babb.no]

@b0rk yes to more good docs! git becomes very easy once one "gets" the data model -- the tricky task becomes to figure out appropriate command to run to do something

[mvidner@witter.cz]

@b0rk I love your work, Julia! You are an inspiration.
(Been using git for 18? years. Subversion ams CVS before that)

[khleedril@cyberplace.social]

@b0rk Near the end of the git-push page, under ``git push origin +dev:master'', the second diagram looks wrong to me.

[alper@rls.social]

@b0rk Thanks for the work of improving fundamental documentation for what is such an essential and widely used tool. I hope the work is not "thankless".

[ddbeck@mastodon.social]

@b0rk did you do this out of your own interest? Or do you have some kind of funding to do this work?

[b0rk@social.jvns.ca]

@ddbeck I funded all my own work on it, I took a break from doing normal Wizard Zines work for a bit

the experience made me curious about the open source docs funding landscape though, i’m going to watch the talk i saw on your site about resources

[ddbeck@mastodon.social]

@b0rk thanks for explaining! Erin and I kinda glossed over where to get money in our talk. Google's Season of Docs was the only docs-specific funding program that I knew of, but it has sadly ended. Docs funding seems to come through weird one-off sources, or attached to new development work. I ought to write more about this phenomenon.

[b0rk@social.jvns.ca]

@ddbeck I’d love to read that, I was sad to hear Season of Docs ended

[db_geek@norden.social]

@b0rk @stsp As far as I understand, author and committer are mostly relevant for projects, where change requests are approved and finally added by maintainers.

"The author is the person who originally wrote the work, whereas the committer is the person who last applied the work. So, if you send in a patch to a project and one of the core members applies the patch, both of you get credit — you as the author, and the core member as the committer."

https://git-scm.com/book/en/v2/Git-Basics-Viewing-the-Commit-History

[theory@xoxo.zone]

@b0rk This is awesome, Julia. Thank you! I've not read the Git docs much over the years because they contain so much jargon. Your changes will help a *ton.*