improved doc examples