Phoenix Docs

[Peter Royal <pr...@apache.org>]

All the current phoenix docs seem more high-level. I'd like to start writing 
xdocs for the various components that exist in kernel.xml (the choices for 
different roles, and the configuration options that they have).

Do any of the more "regular" docu-writers have any preconceived thoughts 
before I rush in?

-pete


-- 
peter royal -> proyal@apache.org

--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>

Re: Phoenix Docs

[Leo Simons <le...@apache.org>]

On Fri, 2002-08-02 at 17:18, Peter Royal wrote:
> All the current phoenix docs seem more high-level. I'd like to start writing 
> xdocs for the various components that exist in kernel.xml (the choices for 
> different roles, and the configuration options that they have).
> 
> Do any of the more "regular" docu-writers have any preconceived thoughts 
> before I rush in?

thought: "yay, more people doing docs!"

thought 2: "we better make sure we have some stability in these files
otherwise it'll just change again and the docs will be worth nothing.
Documenting stuff that will get refactored is a bit of a waste of time."

opinion: "we need specification (ie DTD) more than guides atm"

:D

- Leo, considers himself one of those "regulars", since he doesn't
commit much code at all =)



--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>

Re: Phoenix Docs

[Peter Donald <pe...@apache.org>]

On Sat, 3 Aug 2002 01:18, Peter Royal wrote:
> All the current phoenix docs seem more high-level. I'd like to start
> writing xdocs for the various components that exist in kernel.xml (the
> choices for different roles, and the configuration options that they have).
>
> Do any of the more "regular" docu-writers have any preconceived thoughts
> before I rush in?

I am in the process of reworking the embeddor to make use of the containerkit 
abstractions. Which means you will hopefully get more useful error messages 
when setting up kernel. This is a result of me spending 15 minutes trying to 
figure out what was wrong with one of the kernel components that hads its 
exception silently swallowed during startup ;)

-- 
Cheers,

Peter Donald
'Most men would rather die than think. Many do.'
                             Bertrand Russell


--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>