Update README.md

Author: mzruya

README.md

@@ -1,18 +1,19 @@
 # Codeowners
-The [oxidation](https://wiki.mozilla.org/Oxidation) of an [existing CLI](https://github.com/rubyatscale/code_ownership) written in Ruby.
-This tool generates Github's `CODEOWNERS` file, assuming certain conventions around Ruby/Javascript packages.
+This is a CLI tool to generate Github's `CODEOWNERS` file from an existing project assuming certain conventions around file annotations and Ruby/Javascript packages.
+It's also the [oxidation](https://wiki.mozilla.org/Oxidation) of an existing [CLI tool](https://github.com/rubyatscale/code_ownership) written in Ruby.
 
 `CODEOWNERS` generation happens as part of our git commit hooks and on Gusto's main repo takes ~18s to run. The Rust implementation which is a drop in replacement cuts that down to <= 2s. (Tested on a Mackbook M1)
 
-```
+### Documentation
+```bash
 A CLI to validate and generate Github's CODEOWNERS file
 
 Usage: codeowners [OPTIONS] <COMMAND>
 
 Commands:
   generate               Generate the CODEOWNERS file and save it to '--codeowners-file-path'
   validate               Validate the validity of the CODEOWNERS file. A validation failure will exit with a failure code and a detailed output of the validation errors
-  generate-and-validate  Chains both 'generate' and 'verify' commands
+  generate-and-validate  Chains both 'generate' and 'validate' commands
   help                   Print this message or the help of the given subcommand(s)
 
 Options: