[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
|
Re: [servlet-dev] References to old versions of the Spec
|
The history / change log should be removed, or rather cleared out and
added to going forward.
Mark Thomas wrote on 1/30/20 3:20 AM:
> 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
>>
>
> _______________________________________________
> 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
>
