Re: [servlet-dev] References to old versions of the Spec

[Mark Thomas <markt@xxxxxxxxxx>]

On 30/01/2020 10:59, Stuart Douglas wrote:
> I just started to look at cleaning up the spec document, and the first
> thing I noticed is that is contains a lot of references to old versions
> of the Servlet spec, e.g things like.
> 
> 'New since version 2.4 of the Java Servlet
> specification is the ability to configure filters to be invoked under
> request dispatcher _forward()_ and _include()_ calls.'
> 
> Also the full changelog etc.
> 
> Do we need to keep all these references to what had changed in previous
> specs?

I kept them for EL and WebSocket but I suspect they were shorter and
less work to update.
 
> I think we should make a clean break for a couple of reasons:
> 
> - It makes the spec smaller and easier to maintain
> - These historical references no longer really make sense, as this is a
> new namespace so largely a new spec
> - If anyone is interested in the history they can refer to the old
> Servlet 4.0 spec

I don't have a strong feeling one way or the other. I'm happy following
the majority. If we do drop the history, I do think we should have a
pointer to the 4.0 spec somewhere so readers can find it if they
need/want to.

Mark


> Note that I am not saying we should not have a change log for changes
> going forward, but just that I don't really see the value in cleaning up
> references to history that are not really part of the same spec anymore.
> 
> Stuart
> 
> _______________________________________________
> servlet-dev mailing list
> servlet-dev@xxxxxxxxxxx
> To change your delivery options, retrieve your password, or unsubscribe from this list, visit
> https://www.eclipse.org/mailman/listinfo/servlet-dev
>