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)