make now works as expected

Just a small commit - fixing make and reordering a portion of the documentation.