So I just have a theory question here and I'm looking for a brainstorming session.
In our product, we have many different of "roles". Some of these roles are defined in our dataload JSON and others are defined in our bootstrap SQL.
Throughout our code, we refer to specific roles by name. We want to provide some sort of documentation for these roles when we mention them in documentation, but we don't want to maintain multiple definitions/descriptions for these roles (ie: we don't want one for documentation and a separate one for execution).
Can anyone think of a way we can "expose" the role definitions to the documentation? The best thing I've got is adding some sort of "export script" to each generation of the javadocs, but I don't have a clue how, or if, that can even be done...