19.02.2008, 18:50 | #1 |
Участник
|
mfp: Anyone interested in developer documentation of X++ code?
Источник: http://blogs.msdn.com/mfp/archive/20...or-x-code.aspx
============== A new feature in Dynamics AX 2009 enables developers to write developer documentation directly in the X++ Editor while writing the production code. The feature is very similar to the XML documentation feature in C#. Basically any method can contain /// (triple-slash) comments followed by structured documentation in XML format. Here is an example: The developer is assisted by a dynamic documentation template, which is inserted through an editor script. The template automatically builds a skeleton including all the required tags for the current method. On top of this the written documentation is validated by best practice rules; which effectively prevent the documentation from growing stale. Finally a tool enables extraction of the documentation, so it can be processed outside AX, e.g. for publishing on MSDN. But who really cares about this? Great tools won't make my day - I want documentation! Dynamics AX 2009 contains about 125.000 table and class methods in the SYS layer. To give a perspective on this number, it will take you over 15 years to document them all, if you can document 5 methods an hour. All the methods shipping with Dynamics AX 2009 will have some documentation:
============== Источник: http://blogs.msdn.com/mfp/archive/20...or-x-code.aspx
__________________
Расскажите о новых и интересных блогах по Microsoft Dynamics, напишите личное сообщение администратору. |
|