[tei-council] Fwd: Re: TEI deprecation practices

[Kevin Hawkins]

Forwarding Laurent's message (since it was likely rejected by the 
mailing list as coming from a non-member) ...

-------- Original Message --------
Subject: Re: TEI deprecation practices
Date: Mon, 6 Aug 2012 14:10:06 +0200
From: Laurent Romary <Laurent.Romary at inria.fr>
To: Kevin Hawkins <kevin.s.hawkins at ULTRASLAVONIC.INFO>
CC: TEI Council <tei-council at lists.village.Virginia.EDU>

Hi Kevin,
Let me try at least to state the workflow I would have in mind for the 
use of tickets for deprecation:
- when the council decides to deprecate "something", a ticket with 
status="deprecated" is created that describes the actual deprecation 
thing. This ticket also states a deprecation period (or open until the 
council decides the "thing" should definitely disappear)
- closing the ticket means that the deprecation period is over, namely 
that the element, attribute,feature etc. has been removed from the guideline

The ticket has thus a multiple roe:
- it documents the deprecation (thus making it easy to publicize (in 
particular on the TEI website)), as a sort of reified warning
- it allows the community to react to the ticket ("no, stop! I have a 
zillion documents using this")
- trace back decisions/reasons for changes

In no way, IMHO, "old" tickets should be changed to status="deprecated" 
, but a new one should be made, which in turn may point to the initial 
discussion(s) that lead to its creation.

And this for both soft and hard, I would say.

Does this help?
Cheers,
Laurent


Le 4 août 2012 à 22:42, Kevin Hawkins a écrit :

> Councilors (cc'ing Laurent),
>
> I've been having some confused discussions with various people about deprecation practices for the Guidelines, and I realized that I was not even sure of our practice any more.  I've done lots of archeology in meeting minutes and in Sourceforge and have produced what I think is a summary of our deprecation practices, plus some questions:
>
> http://wiki.tei-c.org/index.php/Deprecation
>
> Please review.
>
> I hope once we sort this out, I will be able to move forward on http://purl.org/tei/bug/3376456 , and it might also help James with http://purl.org/tei/bug/3435326 .
>
> By the way, I've added a link to the wiki page from a new question and answer I've just added to the Council FAQ:
>
> http://wiki.tei-c.org/index.php/TEI-Council-FAQ#In_what_ways_will_Council_break_backwards_compatibility.3F
>
> Thanks,
>
> Kevin

Laurent Romary
INRIA & HUB-IDSL
laurent.romary at inria.fr