Addressed Josh comments and improved structure and some titles

What is it?

• New content
• Update existing content

Metadata

• Milestone: %BuildStream_v1.2
• Follow up from: #1 (closed)

Rationale

• Addressed comments from @Qinusty
• Improved titles