Idea: Add more beginner-friendly guides and examples to the README

Labels: area/documentation kind/feature priority/backlog

Timeline

Kolja Sam (koljapluemer) opened

Hello, me again, with another thing relating to the README :)

I think there may be value to add some more specific examples to the README, especially in regards to onboarding/first time use. Just got the software working on my machine, and here are some things that would have made my life easier:

  • a guide which release file is the right one for the most common Linux distros
  • a full example for the installation progress in Linux, including making the file executable and a ready-made mv command to move it into path
  • an explanation that git bug user create in fact pulls in your standard git identity, and you don't have to bother with adopt in the default case
  • making sure that what you get when you use --help on a (sub)command is also what is explained in the README
  • a heads-up that identity in the interactive bridge-adding process is just your username, and that you will be guided through optionally the auth key creation if you wish
  • generally, a full run through the detailed getting-started process of someone downloading and using git-bug for the first time

I hope this is helpful, and please don't take it as criticism. My point is only that adding some more stuff in this direction may help with getting new users smoothly going without snags :)

Anyways, have a good one 👋

sudoforge added label kind/feature

sudoforge added label priority/awaiting-more-evidence

sudoforge added label area/documentation

sudoforge added label triage/needs-approval

sudoforge commented

I agree that the documentation could be improved in a variety of ways, and that a more clear onboarding guide would be beneficial, especially to newer users. Any chance you'd be interested in taking a stab at this?

Kolja Sam (koljapluemer) commented

currently rather busy, but if this is still open in a month or so, I might

sudoforge removed label priority/awaiting-more-evidence

sudoforge added label priority/backlog

sudoforge removed label triage/needs-approval

sudoforge added label priority/awaiting-more-evidence

sudoforge removed label priority/backlog

sudoforge removed label priority/awaiting-more-evidence

sudoforge added label priority/backlog