http://www.russellbryant.net/blog/2008/10/29/xml-documentation-of-dialplan-applications-and-functions/ Asterisk Open Source Software Engineering Wed, 17 Feb 2010 15:24:56 -0400 http://wordpress.org/?v=2.8.4 hourly 1 http://www.russellbryant.net/blog/2008/10/29/xml-documentation-of-dialplan-applications-and-functions/comment-page-1/#comment-771 Chuck Wagner Mon, 08 Dec 2008 00:10:21 +0000 http://www.russellbryant.net/blog/?p=157#comment-771 A suggestion - I'm working on a similar project for an api provided by our product to our partners. I found that XML imposed such a high readability barrier that actually writing documentation was problematic. We've switched to YAML instead, and it's turned out to be much more effective. (And simple, since we can even embed XML fragments in the documentation without any special escaping.) A suggestion – I’m working on a similar project for an api provided by our product to our partners. I found that XML imposed such a high readability barrier that actually writing documentation was problematic. We’ve switched to YAML instead, and it’s turned out to be much more effective. (And simple, since we can even embed XML fragments in the documentation without any special escaping.)

]]>