improved doc snippets