[jboss-as7-dev] Deployment Phase documentation

[Brian Stansberry]

I agree this should be a separate guide. The target audience for this 
chapter is really ISVs or developers of projects that need to properly 
integrate with the AS. If a regular sys admin browses the ToC, happens 
to see some heading that seems relevant to some ordinary admin task, and 
drops into this chapter he or she is likely to freak out a bit. ;) 
Conversely, a subsystem developer may never even see this chapter.

Should all these guides include a brief bit early on linking to all the 
other guides and briefly explaining what they are?

On 7/20/11 9:38 AM, Kabir Khan wrote:
> This is part of the Extending JBoss AS 7 chapter - there is talk about possibly making this a self-contained guide. I guess for now I could make it clearer at the start of the chapter that this is an advanced topic
>
> On 20 Jul 2011, at 09:47, Sebastian Otaegui wrote:
>
>> my 2 cents:
>>
>> I am a sysadmin, and as such I find it really helpful for troubleshooting issues to have a better understanding exactly what a system is doing and how it processes a deployment.
>>
>> If it is not part of the admin guide at least there should be a reference in the admin guide to the chapter of the "Advanced Developer" where the deployment phases are explained.
>>
>>
>>
>> On Wed, Jul 20, 2011 at 2:01 AM, Heiko Braun<hbraun at redhat.com>  wrote:
>>
>>
>> IMO this doesn't belong in the admin guide.
>> The admin guide is intended to be used by the average sysadmin
>> and help them to configure and maintain application server instances.
>>
>> deployment phases and attachments go way beyond that.
>>
>> maybe the "Advanced Developer" guide is a more appropriate place.
>>
>>
>> On Jul 19, 2011, at 5:49 PM, Kabir Khan wrote:
>>
>>> I made a very feeble start on documenting the deployment phases here: https://docs.jboss.org/author/display/AS7/Admin+Guide#AdminGuide-Deploymentphasesandattachments
>>>
>>> If someone more familiar with the deployers has the cycles to improve on this I would really appreciate it. If not I will try again later this week once I've refamiliarized myself with the different parts.
>>> _______________________________________________
>>> 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
>>
>>
>>
>> --
>> Those who do not understand Unix are condemned to reinvent it, poorly.
>> Any sufficiently recent Microsoft OS contains an ad hoc, informally-specified, bug-ridden, slow implementation of half of Unix.
>
>
> _______________________________________________
> jboss-as7-dev mailing list
> jboss-as7-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/jboss-as7-dev


-- 
Brian Stansberry
Principal Software Engineer
JBoss by Red Hat