-
1. Grand Unified Tweak Documentation?
jaikiran Jan 24, 2011 9:15 AM (in response to nickarls)Nicklas Karlsson wrote:
Unfortunately, no. Maybe we should start a wiki article and keep adding to it.
-
2. Grand Unified Tweak Documentation?
nickarls Jan 25, 2011 2:15 AM (in response to jaikiran)The problem is that (if I understand correctly) almost any internal file can have it's attributes set through XML files even if it makes sense or not.
Perhaps it would be an idea that for AS 7, the module leads (or people who Know Stuff) would add an annotation for fields that are candidates for configuration and then the documentation would be auto-generated. Something like
@Configurable(description="TLD's getting you down? Cut some corners by settings this to false and you can skip validation")
public void setUseSchemaValidation(boolean useSchemaValidation)
{
getHelper().setUseSchemaValidation(useSchemaValidation);
}
You could then generate a nice list with bean - property - description. With another annotation for the file location within the AS, you could even generate links to the correct file. Perhaps.
-
3. Grand Unified Tweak Documentation?
jaikiran Jan 25, 2011 3:23 AM (in response to nickarls)Nicklas Karlsson wrote:
For AS7, the configurations (meant to be done by users) has been minimized and the goals are to make sure that some random internal AS specific configurations don't end up in these files. Here's one such thread which explains the goals for AS7 http://community.jboss.org/message/574143#574143 with regard to this topic.