http://staruml.sourceforge.net/en/

Check it out. Open source. Free. It doesn't suck. What more would we want :-)

In the identity component, I documented the java model and a preliminary version of the database model. Its in the package org.jbpm.id and it will be exposed in the javadocs as well.

That is how I would like to document all pvm related projects.

I couldn't really get the the previous eclipse based stuff that Bull people referred to me to work properly.

Please have a look at this and let me know what you think.