Add more examples to the reference documentation

[pjcozzi]

Some parts of the reference doc have enough examples, others could use more. For example, only some Matrix4.js members have examples (search for @example). Of course, trivial members, like boolean properties, do not need examples.

A reasonable approach here would be to start with the files in Core, and to open pull requests for every file or every few files.

[pratnala]

Hi, can I get some pointers for this? How to start etc.?

[pjcozzi]

@pratnala thanks for the interest.

Take a look at the reference doc (in the code comments) for some of the files in Core that interest you. For example, perhaps Cartesian3.js or Matrix3.js. Add short code examples (using @example) to the reference doc for non-trivial members. For an example, see Cartesian3.fromArray in Cartesian3.js.

For these files, you may be able to base examples on the tests: Cartesian3Spec.js and Matrix3Spec.js.

[nobelium]

@pjcozzi I have added examples for Matrix4.js and opened a pull request #724

[pjcozzi]

This can happen as needed as part of #1684