Developer API Reference, examples

I would like to strongly encourage including many more usage examples in the Developer's reference. Just a few example lines of code using the definitions found on a page would often be very helpful. This is the single best place to put examples: 1) it is a searchable document, 2) only snippets need to be provided and 3) it is a very suitable place for example/ usage snippets to accumulate over time, only increasing its value over time as a reference. A great place to accumulate answers to questions, in the manner of a FAQ.

Simple things would help. How are Highest and Lowest used? Sum and Subtract series are already included and are helpful. A strategic intention to include an example with every definition would be most propitious.