It'll already take a tremendous amount of time to get the user's side up and
going, which is what I think the grand majority of people will benefit the
most from. I'm not saying the dev design docs aren't extremely important,
I'm just saying that I want to spend my time where it will have the greated
effect =)
- r
> -----Original Message-----
> From: Antony Bowesman [mailto:[EMAIL PROTECTED]]
> Sent: Wednesday, July 04, 2001 2:19 AM
> To: [EMAIL PROTECTED]
> Subject: Re: TC4 docs - can we end this?
>
>
> "Rob S." wrote:
> >
> > So please, can we at least START some discussion about the
> > contents of the docs other than "we need to write them" ?
> > There's a lot of work to be done, and I would imagine that
> > someone knows where a good place is to start.
>
> Let's start from the bottom up. We already have the servlet API spec,
> so how about architectural design specs. Filip Hanik, in his Tomcat
> Interceptors project, has some useful documentation and I have earlier
> provided feedback to him.
>
> However, I recently implemented a realm for TC 3.x and had some
> difficulties. I had to understand TC source code to get a feel for the
> request processing architecture. Some areas of Interceptors and
> Contexts are still unclear. For example, what are notes? These are
> referred to in ContextManager quite a lot and the SimpleRealm
> implementation but the purpose of them in a mystery. Questions on the
> list didn't get replies.
>
> What issues need to be considered when extending things like
> BaseInterceptor with regard to the contexts, JVMs, class loaders and
> synchronisation requirements.
>
> I know it's a moving target all the time but architectural specs would
> help in getting more people involved in writing better code for the
> overall project.
>
> Antony
>
