"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