Extensible Documentation Mark-up Language

DocML lets you create semantic, stand-alone documentation for software written in a wide range of programming languages. By creating documentation in DocML, you not only keep your code clean of unnecesary comments and references, but also store that information in a format which is portable, platform independant and allows for richer visual output and manipulation.

A simple DocML file would look something like this:

  <?xml version="1.0" encoding="UTF-8"?>
  <docml name="My Project" version="1.0" code="php" lang="en-us">
      <fn name="myFunction" desc="An example function">
          <return type="boolean"/>
          <code>
              <![CDATA[
              myFunction('Hello World');
              ]]>
          </code>
          <args as="aguments">
              <arg name="text" type="string" req="true" />
          </args>
          <src>
              <![CDATA[
              function myFunction($text) {
                  echo $text;
              }
              ]]>
          </src>
      </fn>
  </docml>