expand spec with examples from the original doc