Document blocking calls.
Remove development reference from docs sidebar.
Merge pull request #1413 from Lukasa/docs

Assorted docs updates