Thread: Javadoc link to external resource

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...

In your code, you should probably be referring to variables defined somewhere, not hard-coded constants. All you really need to do is javadoc these variables.

See the SwingConstants interface for an example of what I'm talking about.

The role variables are defined in the dataload JSON and the bootstrap SQL, which is where the descriptions for the variables are. I'm not 100% sure on the exact way they are imported at runtime.
The problem is that when the API is generated, the descriptions for the roles are not provided in any way, since the source of the roles is a resource instead of code. Ideally, we'd like to pull those descriptions out somehow for the documentation.