compression.zlib: add basic documentation

These are very minor doc changes.  I wasn't sure whether to document all the words (the general rule inspecting other doc files seems to be *not* to document obvious things, such as `zlib-failed`), so I didn't, but I'm happy to go back and do those.