Update based on comments from the packaging committee
- Describe Makefile as optional
- Remove "Git Repository setup" section
- Change section label syntax to work with "asciidoc" properly
(please "fixup" this commit before accepting the pull request)