Documentation for Castor in a multi-threaded environment

Following on from JIRA http://jira.codehaus.org/browse/CASTOR-2111, I would like to open this JIRA to request additional documentation on loading castor mappings in a multi threaded application.

My recommendation would be to reference the section "Best practices" for XML from the earlier examples "Using XML" which shows how to load a mapping in its most basic form.

This would involve referencing this page

http://www.castor.org/xml-best-practice.html

from here

http://www.castor.org/xml-framework.html

with a note stating that important information for castor in a multi-threaded application is contained here.

Also a new HOW-TO page would be of great benefit. It should describe the process of loading mappings in a multi-threaded environment.