Introduces a new folder "examples" that will host documented examples in the future. There are different from tests, which are meant only for testing and are not necessarily instructive.
Fixes #520 (closed) Fixes #378 (closed)