go to post Mike Dawson · Jul 13, 2016 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
go to post Mike Dawson · Jul 13, 2016 Thanks Sergei, this is exactly what I was looking for.I notice that we already differ from your standard quite a bit. I have looked at a lot of InterSystems Ensemble code over the years and have sort of inherited their style.We also insist on using #dim for all variables to prevent spelling mistakes causing problems.Regards Mike
go to post Mike Dawson · May 6, 2016 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.
go to post Mike Dawson · Mar 8, 2016 Thanks for this Murray. I am just sending to our system manager!(We don't run pButtons all the time but perhaps we should)