cleanup and clarify documentation for write-only workbooks

Created originally on Bitbucket by Daniel Lenski

Changesets for this Pull Request have not been imported, because it had been already declined on Bitbucket. Marked as closed by the import user.

Write-only documentation had an incomplete example, referred to the obsolete optimized_write parameter, and left out a few important features of write-only workbooks.