We could imagine several levels of sophistication:

1. just a comment pointing back to the test class and a pointer from the test class to the documentation
2. an automatic system taking an example from the source and copying it when building the documentation

1. can be relatively easily done as background task over time and is needed for 2.
2. requires some harness I'm not sure we want to invest right now

This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira