All-Doc solves the problem of documentation becoming out of sync with the code. By defining the documentation close to the code it is more likely that when the code gets updated the documentation will too.
Unlike Javadoc, All-Doc can be abstracted away from the code itself to deal with higher level documentation such as web-service documentation.
In future versions the ability to use special all-doc files to populate expressions that are referenced in the classes. This will also bring the ability to localise documentation and provide some extremely powerful reflection variables for use within these files.
