[jboss-user] [Microcontainer] - Re: Tool for documenting MC beans

[jesper.pedersen]

There are two level of users here.

1) End users
2) Other developers inside JBoss

End users should hopefully never see the jboss-beans.xml files - but that is the case today unless you plan to fix that.

The foundation of our projects should be the MC, but if there isn't any documentation for the MC beans available each project will start to code duplicated functionality. Asking Ales in the forum each time a bean is needed doesn't scale. Period.

All I'm asking for here is a tool that can allow a project to document the MC beans they want to expose to other developers - or in case they don't have an up-to-date users guide to the end user.

Kabir, an example of how TLD documentation looks like http://www.jboss.org/file-access/default/members/jbossrichfaces/freezone/docs/tlddoc/index.html

AS is a black box in how services (interfaces, properties, ...) are exposed and glued together - and I don't see a developer guide explaining that happening any time soon.

View the original post : http://www.jboss.org/index.html?module=bb&op=viewtopic&p=4230904#4230904

Reply to the post : http://www.jboss.org/index.html?module=bb&op=posting&mode=reply&p=4230904