How to document examples
What structure should we use to include examples in the doc? Separate section we can structure as we like? Examples for each text page? (I think not the best.) Examples for classes / properties? (Might be hard given the tool we use to generate the specification document.) I guess my current vote is a new section, what do you think @elf-pavlik ?
I think the first sets of examples should be very simple examples for all the basic concepts. The purpose would be to help people who are just starting to explore understand the concepts.
Then we can do more complex examples of different use cases - maybe for this release or maybe not.