Keeping documentation content up to date

[vansimke]

Currently, documentation, such as reference guides, are completely hand-written. Over time, this could become a maintenance challenge as Dojo's features evolve and develop since the guides have to be manually reviewed and updated.

Ideally, critical portions of documentation could be either automatically generated from the source code or supported by some sort of test to ensure that the documentation is still correct.

Please use this issue to record thoughts on the feasibility of this idea as well as capture ideas about how we might be able to implement it.