Document the way we interact with git

[smashwilson]

Most interestingly, the way we intercept various kinds of credential prompts, and the differences between the different layers of the interface (what lives in GitShellOutStrategy vs. Repository and its states).

cc @sguthals @kuychaco @annthurium @vanessayuenn

🦄 r e n d e r e d 🦄

[coveralls]

Coverage decreased (-0.8%) to 81.093% when pulling 19856cd on aw/git-docs into 2466c36 on master.

[vanessayuenn]

This is a super informative & helpful doc! Thanks for writing this! ✨

A small comment: although I see how the sections under Repository is closely related to the git interactions, it's probably important and big enough of a topic to warrant its own doc?

[smashwilson]

[..] it's probably important and big enough of a topic to warrant its own doc [..]

Do you mean the Repository states description? There is a bit more information about that (like a state transition diagram) in a README in the lib/models/repository-states directory. I could link that here maybe 🤔

[vanessayuenn]

Oh yes I didn't realize we have this doc outside of docs/. Yea I think a link would help discoverability.

[kuychaco]

Looks good to me! Thanks for writing this up @smashwilson 🙇‍♀️

[smashwilson]

Thanks for reading it over 🙇