timeline widget documentation

Hi,

As far as I can tell, there isn't any documentation for the timeline widget. It should be hyperlinked where it's listed here, but its not.
http://cesium.agi.com/Cesium/Build/Documentation/Viewer.html?classFilter=viewer&show=all
This doesnt exist:
http://cesium.agi.com/Cesium/Build/Documentation/Timeline.html

I can see the functions in the source here
https://github.com/AnalyticalGraphicsInc/cesium/blob/master/Source/Widgets/Timeline/Timeline.js
But does the lack of documentation/examples mean that these are less-than-official features to access, or is it an oversight?

Thanks

A little bit of both. The Timeline is some of the oldest widget code in Cesium, and was written before our coding standards and widget architecture was put into place. We have an issue to refactor and document it so that it’s everything we want it to be (see https://github.com/AnalyticalGraphicsInc/cesium/issues/754), but we haven’t gotten around to it yet.

You can certainly use it in the meantime, lots of people are and it’s part of the Viewer widget. See the Timeline demo in Apps\TimelineDemo for a simple example. You can also look in the Viewer code which adds it to a page: https://github.com/AnalyticalGraphicsInc/cesium/blob/master/Source/Widgets/Viewer/Viewer.js

It’s as official as anything else in Cesium is, so if you run into bugs/problems, just let us know.

Thanks for the info!