updating docs, overview section one
finished section two of overview
updated portability picture
minor typos
Merge pull request #3871 from ivanov/doc-improvements-1.0

I'm updating the docs, fixing small things that have been removed (or added).