Hi, I see quite a lot of emails on this list that explain new features in detail - this is cool, but IMO it would be much better to have that info in JIRA, and only or mostly pointers here.
As an example from another project, SLING-550 describes a feature that I implemented in Sling, which is not officially documented but you can find all the required info in there to use it: use case, how to activate and test the functionality, etc. If you want to use Sling background servlets, I can just tell you to go look at SLING-550. No need to hunt in mailing lists and even if you need to you can search for the "SLING-550" string as a unique feature ID. Having such a "master issue" for each new feature, which describes (or points to) usecases, installation and test information, all with permanent URLs, is IMO much more valuable than email scattered around. Such an issue is often good enough as documentation, as we won't reach our dream of correctly documenting everything soon. Hope this helps, -Bertrand
