Document in README how to install and use

Open Beginner friendly
#3 0 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
78/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Stale
Tech stack
python
Domain
documentation

Research direction

Start by reading the existing README and running the tool's --help output. Document that installation consists of copying the files into /usr/local/bin/ or another directory on PATH, and include the help output so the installation and available usage are clear.

Written by the indexing model from the issue text.

Description

The tool itself has a pretty nice --help output, once you get to running it at all.

When coming upon the repo here on GitHub, you don't see that and instead you see the README. It'd be really helpful for that to (a) say how to install it (it's trivial, in fact -- copy the files into /usr/local/bin/ or elsewhere on your PATH -- but that needs to be written down), and (b) maybe just have a copy of the --help output, so you can see what you'll get.

Dominant language
Python
Stars
16
Forks
3
PR merge metrics
No merged PRs in 30d

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from dropbox/git-rbr

All issues in dropbox/git-rbr

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.