more examples, specs and explanations