For anything you want other people to use really

Unless you want to filter for the most determined only !

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...