README formatting - make guidelines a bullet-list
contrib: rewrite 'documenting snippets'