Add vision and design principles doc

[jesseduffield]

I want to spell out the design principles behind Lazygit so that our priorities are clear and it's easier to make UX decisions (especially for early contributors).

It's not possible to codify this in a way that will resolve all disputes but I think it's worthwhile to enumerate some of the things that keep coming up in our discussions about X or Y feature.

This is a very rough draft (effectively a brain-dump). So I expect plenty of feedback :)

CC @stefanhaller @karimkhaleel @mark2185 @afhoffman @AzraelSec

• Please check if the PR fulfills these requirements

• Docs have been updated if necessary

[codacy-production]

Coverage summary from Codacy

See diff coverage on Codacy

Coverage variation	Diff coverage
Report missing for a4ecd291	✅ ∅

Coverage variation details

	Coverable lines	Covered lines	Coverage
Common ancestor commit (a4ecd29)	Report Missing	Report Missing	Report Missing
Head commit (b174791)	51443	44423	86.35%

Coverage variation is the difference between the coverage for the head and common ancestor commits of the pull request branch: <coverage of head commit> - <coverage of common ancestor commit>

Diff coverage details

	Coverable lines	Covered lines	Diff coverage
Pull request (#4053)	0	0	∅ (not applicable)

Diff coverage is the percentage of lines that are covered by tests out of the coverable lines that the pull request added or modified: <covered lines added or modified>/<coverable lines added or modified> * 100%

See your quality gate settings    Change summary preferences

_{Codacy stopped sending the deprecated coverage status on June 5th, 2024. Learn more}

Footnotes

1. Codacy didn't receive coverage data for the commit, or there was an error processing the received data. Check your integration for errors and validate that your coverage setup is correct. ↩

[karimkhaleel]

Suggested change

	- Comformity with git
	- Conformity with git

[karimkhaleel]

Document how to solve various git problems with Lazygit

Strongly agree with this point. Too often I see people struggling with their repos because they are not even aware of many of the ways you can manipulate commits and branches. I really like how Lazygit allows Git's features to be very easily accessible and not behind a completely opaque UI (i.e you can see exactly what git commands are running in the background).

[jesseduffield]

I'm gonna go ahead and merge this. Still open to feedback on it but no harm in getting this first-cut in.