/,blocks: documentation improvements