[giancarlostoro]

The law for making a new language: always include examples up front.

[erwan]

For anything you want other people to use really

[agumonkey]

Unless you want to filter for the most determined only !

[sn41]

Even in pure mathematics, a good rule is to give examples (if simple) right after the definitions. Examples always help.

Here's a post by the Fields medallist Tim Gowers:

https://gowers.wordpress.com/2007/10/19/my-favourite-pedagog...