Thanks Eduard, this is a good starting point for my document.

I notice that you allow methods to return objects rather than %Status. I have looked at a lot of InterSystems Ensemble code over the years, and the general style is to always return a %Status and any object oRefs required are passed out as Output parameters. Would you say that this is the most common style?

Regards Mike

My two top gripes with the current documentation:-

Searching.  The search regularly fails to find pages that I know are there or shows pages that are not relevant to my search. In the days of powerful internet search engines this is really frustrating and disappointing.

Lack of sample code. They say a picture is worth a thousand words, well some sample code works the same way!  Come on guys if you have just documented a class with scores of methods and properties  give us some sample code showing normal invocation.