[jboss-as7-dev] Documentation - Naming conventions

Kabir Khan kabir.khan at jboss.com
Thu Jul 7 09:17:28 EDT 2011


I'll replace all occurrances in the admin guide
On 7 Jul 2011, at 13:13, Pete Muir wrote:

> I spoke to Jason, and we should refer to it as:
> 
> JBoss Application Server 7 or JBoss AS 7
> 
> On 4 Jul 2011, at 12:26, Pete Muir wrote:
> 
>> I've seen various ways of referring to the project which we are documenting. Normally "JBoss Application Server" is used in the introduction to a guide, and then shortened. Some guides use "JBoss Application Server 7". There is also some inconsistency with using "the JBoss Application Server". I think we should pick one of these (my vote is "JBoss Application Server" with no preceding definite article, you would still want to use a definite article when referring to "the application server" - the difference being that we are using a description of the project, not the project name).
>> 
>> The shorted version is then sometimes referred to as "JBoss AS", sometimes as "AS", sometimes as "AS7", sometimes as "AS 7". My pick would be "JBoss AS".
>> 
>> I think it's fairly important we use a single convention so that people get a consistent experience with our docs. What do others think? Misty, what do you use for the enterprise docs - that could be a good convention to adopt (swapping EAP -> AS).
>> 
>> 
>> _______________________________________________
>> jboss-as7-dev mailing list
>> jboss-as7-dev at lists.jboss.org
>> https://lists.jboss.org/mailman/listinfo/jboss-as7-dev
> 
> 
> _______________________________________________
> jboss-as7-dev mailing list
> jboss-as7-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/jboss-as7-dev




More information about the jboss-as7-dev mailing list