Documentation Improvements

Hello everyone,

We’ve recently made some improvements and modifications to our documentation tool, resulting in more complete and usable reference documentation. If you are currently using Cesium, you may need to launch the clean target before building a new release or clear your browser’s cache for the new documentation to appear. Finally, as you continue to contribute to Cesium, please refer to our new Documentation Best Practices wiki as you document your code.

Thanks,

Kristian

The full example still has DOC_TBA and does not have an @example. :slight_smile:

Patrick

Duly noted and fixed. That’s what happens when one uses copy/paste. :wink:

Several tags were also stripped out of the wiki’s example and are now HTML safe.

Kristian

This best practices guide is a great start. A few comments for us all:

  • Oracle’s How to Write Doc Comments for the Javadoc Tool guide has lots of good advice.
  • Not all of our reference doc is up to par yet. If you are in code - even code you didn’t write - always feel free to improve the doc.
  • As we learn more best practices, let’s update the wiki.

Patrick