Flesh out the build definition documentation a bit more.

Issues affected: #2