7 ms·
Git Commands Explained with Cats (2017)
- wegs 5y agoI think what this needs is a proper scan and vectorization. Author has a nice repo with other doodles: https://github.com/girliemac/a-picture-is-worth-a-1000-words https://github.com/girliemac/a-picture-is-worth-a-1000-words I really wish there were some way to find and navigate good OERs like these.
- dharmaturtle 5y agore: navigation: VS Code can render PNGs, so you can hit the period key on GitHub and just navigate the repo's PNG folders.
- AndrewOMartin 5y agoThis is one of those "explanations" where, if it's a concept I'm familiar with I can apply my knowledge to it and see that it mostly checks out, but if it's something I don't already know, I find completely useless.
- tempodox 5y agoAgreed. Explanations of git sometimes remind me of monad tutorials.
- contravariant 5y agoI suppose you could combine the two by pointing out that git is like a category where a git merge is like a pushout etc.
- lvass 5y agoGit is simply a directed acyclic graph of commits with pointers, stashes, a few named data stores and two quasi-recursion mechanisms.
- tempodox 5y ago“A monad is just a monoid in the category of endofunctors.”
- CrazyPyroLinux 5y ago"It's like a burrito!"
- PebblesRox 5y agoFor the unfamiliar: https://www.google.com/amp/s/byorgey.wordpress.com/2009/01/12/abstraction-intuition-and-the-monad-tutorial-fallacy/amp/ https://www.google.com/amp/s/byorgey.wordpress.com/2009/01/1...
- isaacimagine 5y agoPersonally, as someone who has been sketchnoting for about 5 years, I feel the point of sketchnoting is more to create a condensed visual reference of an idea for personal recall than for teaching that same idea to someone else. There's a wider argument here of whether notes should be used for personal recall or general reference. I tend to lean towards the former, but there's more nuance here. I'm working on a blog post that discusses how to take good sketchnotes and breaks down this argument a lot further, but it's already super long and far from being finished... perhaps I'll finish it someday, haha. Kudos to the original author of these notes. When taking these types of notes, you have to think about what to leave out as much as what to leave in. I think that concise notes in this style to show that the author has a deeper understanding of the subject than the notes convey on the surface, especially when the point of these notes are to compress one's knowledge on the subject into a concise visual representation. Sketchnotes are macroexpand for the brain :P
- shimonabi 5y agoExactly. I use basic git daily, but I'm still confused about rebase.
- gfodor 5y agoI gave up. I determined some of us are just too stupid to do quantum physics or rebase in git without destroying our branch. I'm one of those people.
- mhh__ 5y agoFWIW Git is harder to understand than basic quantum mechanics IMO. The latter has been optimized with good notation and has a fairly simple structure, whereas Git is a beautiful idea wrapped in an API from hell
- frutiger 5y agoRebase is copying a series of commits and pasting them onto somewhere else. By default it will copy commits and apply them onto the new upstream. In other words, go from old your master master ----*----*----A----B----C----D \ \ new \ master \----*----* to old your old master master ----*----*----A----B----C----D \ \ new your \ master master \----*----*----A'---B'---C'---D' Interactive rebase allows you to choose to reorder, rename, combine or drop those commits A, B, C, D as they are applied to new master.
- deleted 5y ago[deleted]
- stinos 5y agoFor me it's the other way around. I mean, it's like one of the few commands which says what it does: re-base. Makes all kind of sense to me: take what you have and put it on top of something else. So same as a bunch of cherry-picks, etc. It was one of the first concepts I undesrtood. Merge on the other hand I understand as well but it leads to graphs I can't understand without spending some time looking at.
- pelagic_sky 5y agoAs a designer. I don’t understand these. I know the overall concept of using git but this didn’t bring me any aha moments.
- deleted 5y ago[deleted]
- deleted 5y ago[deleted]
- aught 5y agoThis is inspiring morning reading for my study day. Seeing posts like this always motivates my note taking.
- barefeg 5y agoNice illustrations but I find it actually harder to understand even though I’m completely familiar with the concepts
- squarefoot 5y agoI'm not familiar with the concepts, save for the occasional git clone, and found it about impossible to understand. And i also love cats.
- SwiftyBug 5y agoMaybe the problem is that you're not familiar with cats?
- nobodyandproud 5y agoAny good onboarding material for someone who comes from traditional (file-based) VCS? I find git is just similar enough to older VCS systems trip one up dangerously.
- einpoklum 5y agoYou could try this article: https://www.codemag.com/article/1105101/Git-for-Subversion-Users https://www.codemag.com/article/1105101/Git-for-Subversion-U... caveat: I have only skimmed it.
- deleted 5y ago[deleted]
- kjhughes 5y agoSee also her sketch notes on other topics (https://girliemac.com/doodles/ https://girliemac.com/doodles/): - Introduction to Programming & Tools - Machine Learning Regression - Notes from Presenting Data & Information course by Edward Tufte - Notes from The State of Web Platform And her list of other Tech Doodlers & Sketchnote artists to follow (https://girliemac.com/blog/2021/07/12/microsoft-beginners-sketchnotes/#tech-doodlers--sketchnote-artists-to-follow https://girliemac.com/blog/2021/07/12/microsoft-beginners-sk...).
- richardfey 5y agoI abhor the related debate, but I wish she had used 'main' instead of 'master' (to avoid further debates)
- einpoklum 5y agoWhile the doodles are cute and colorful, I fear you have to already comprehend the subject matter to appreciate them. This is doubly true since the doodles are in fact pages laden with quite a bit of text. I doubt there is a target audience which fails to comprehend the un-doodlified versions of these doodles, and is helped significantly by the cats and colorfulness.
- chaboud 5y agoFor me, this is both accurate and appropriate. We own four cats in our household, aged 16-25. So they’ve been around almost as long as I can really remember. In all that time, anything I’ve been capable of doing I do much worse and much more slowly when they are present. Playing piano, cooking dinner, writing code.. all crumble in the face of a cat that wants a warm lap (and won’t shut up about it). Understanding git doesn’t feel any different, just more extreme. Anyone who tells you that they fully understand git is mistaken, lying, or named Linus. How is adding cats going to fix that?
- dgfitz 5y agoOh how I wonder how different things might be if mercurial won the dvcs wars.
- mdaniel 5y ago"Slower," in my experience I wonder if having Mercurial continue in python is a development advantage, or it just started out that way but now would benefit from a more performant version
- ape4 5y agoGit commands are confusing. Hopefully they'll be renamed or a neogit will do it better someday.
- corprew 5y agoI was really disappointed when I saw this, but not because of the content, which is great, but because I saw Cats (Year) and assumed that the link was going to be explaining git using the _movie_ Cats. Sadly, the movie was Cats (2019).
- mdaniel 5y agoTeaching new users about "--force-with-lease" may pay dividends over the less considerate "--force": https://git-scm.com/docs/git-push#Documentation/git-push.txt---no-force-with-lease https://git-scm.com/docs/git-push#Documentation/git-push.txt... That is to say: I totally benefit from "git commit --amend && git push --force-with-lease" but 100% percent of the time want that flow to call time-out if someone has pushed before me
- pm215 5y agoUnfortunately as UI a 7 character option is almost always going to win over an 18 character option. I know about --force-with-lease, I know that it would provide an extra safety guard, and I always use --force anyway because it's the short, easy to remember and quick to type one.
- bdcravens 5y agoYou can of course create a git alias https://stackoverflow.com/questions/30542491/push-force-with-lease-by-default https://stackoverflow.com/questions/30542491/push-force-with...
- na85 5y agoUsing a modern shell like zsh allows for tab completion of those options.
- sitzkrieg 5y agogit push <upstream> +branchname is shorthand
- morris082 5y agoCheck out --force-if-includes … it works well in combo with —-force-with-lease and ensures you don’t accidentally replace a branch that is not yet merged into your current branch (force-with-lease has a pitfall where if you fetch before pushing, it’ll act like a straight up force push).
- dan-robertson 5y agoIf only we could instead have an intuitive version control system which didn’t need crazy explanations or for each team to have a ‘git expert’ who has memorised a few more commands for unbreaking the repo than anyone else. But for now, it seems git is here to stay and many collective hours will be wasted cursing the git who designed it.
- jimbob45 5y agoAs a fellow Git-hater, TortoiseGit vastly improved my dealings with Git.
- dan-robertson 5y agoYeah, magit for me. But I feel there ought to be a better way.
- olvy0 5y agoMe too, I use TortoiseGit almost exclusively. I have its log view open almost all the time and do all my git actions from there. I can get along in the command line but I'd rather not, my short term memory is awful. I just like seeing the visual feedback of the actions I've just done.
- BrandoElFollito 5y agoI am an amateur dev who, for the last 10 years, is using 3 git commands with fingers crossed (because my only "git expert" is StackOverflow). GitExtensions[1] vastly improved my life. It is a wonderful program. [1] http://gitextensions.github.io/ http://gitextensions.github.io/
- na85 5y agoGit is an awful tool but for most use cases it's much better than CVS, SVN, or perforce or something. I wish the docs weren't so abysmally bad, and I wish it did a better job abstracting away the internals. I don't have time to learn about git's arcane internal shenanigans. I just want version control.
- u801e 5y ago
- scott_paul 5y agoI showed this to a non technical guy who is trying to learn git. He said he liked the cats but this didn't help him understand it any better.
- pacomerh 5y agocute cats but this is kinda confusing
- SavantIdiot 5y agoReally clear explanations. Much better than the git documentation that uses letters. Visual cues help a lot.
- BrandoElFollito 5y agoFor someone who knows the 3 git commands that allow for a basic usage, such illustrations acre completely useless. There are zillions of introductory tutorials that are much easier to understand. I wonder who the target audience for such drawings actually is.
- smusamashah 5y agoI wrote this long time ago after having rough time learning basics of git myself https://xosh.org/explain-git-in-simple-words/ https://xosh.org/explain-git-in-simple-words/ My qualm with most available explanations back then were that they all start from command line with no visual explanation. Now if you understand that it's a linked list, where nodes link to previous node instead of next, branches and tags and everything starts to make sense.
- voodoochilo 5y agoEmbarrassing.
- girlie_mac 5y agoHi, I am the author of the "Git Purr " doodles here. This probably isn't for everybody but if you like tech && cats, I made "HTTP Status Cats" a long time ago too. I believe that one satisfies more of you. http://http.cat http://http.cat (I don't own the website or the awesome domain name, but the original HTTP Status Cats images are done by yours truly!)
- mrwoggle 5y agoJust printed your doodles and put them on one of our whiteboards. Most of my fellow devs are from a 3D modeling and design background and have a hard time understanding anything more than push and merge (using a GUI). I tried to explain them numerous time, but they just phase out after a couple of minutes.
- reactspa 5y agoTo girliemac: do one for Docker please.
- anonnews 5y agowow, two "I" for every sentence... "I have" "I am" "I studied" "I consider myself" so much ego