Add section on library design
Add cli tool design information
Remove extra spaces after stops
Be consistent about dashes in the project name