[CRISP-TEAM] Version control of the drafts

Mwendwa Kivuva Kivuva at transworldafrica.com
Sat Dec 27 04:47:42 CET 2014


I also support this. There should also be a way to differentiate
outdated documents, not only with a date but also by having a
statement in the beginning of the document like "This document has
been superseded by ...".

On 25/12/2014, Izumi Okutani <izumi at nic.ad.jp> wrote:
> CRISP Team,
>
>
> To seperate "meeting materials" and "official CRISP
> documents/information" on NRO website as suggested by Alan,
> I drafted an example.
>
> ---------------------------------------------------------------------------
> * Draft proposal published by CRISP Team
>
> Date         draft version   Description
> ----        -------------   ------------
> 2014/12/19  version 1.0     Initial draft developed by CRISP Team
> 2014/12/xx  version 1.1     Editorial changes from version 1.0
>                             (To describe answers in the same order as
>                              questions listed in each Section)
>                              No changes in contents of the draft.
> ---------------------------------------------------------------------------
> * Latest CRISP Team Timeline
>   ## Link to the latest Timeline ##
> ---------------------------------------------------------------------------
>
> We should have date, draft versions (with links to each) and describe
> major change(s) from the previous version. Anything else?
>
> This is just one idea, and I'll leave the details to German including
> the format.
>
>
> German,
> We can revise and improve as needed, so please help us post the edited
> version shared by Michael (UTC12:49 12/24), in the format you think is
> the best at this stage. Thanks German.
>
>
>
> Izumi
>
>
> (2014/12/24 18:55), Izumi Okutani wrote:
>> Andrei and all,
>>
>>> And I think by that we meant including the version number in the title
>>> and the URL. I current practice is that the name of the file contains
>>> the date. It'd be also useful if we put the date in the document itself.
>>
>> I agree it's useful to add the date as well.
>> Thank you for clarifying the details, of reflecting version number in
>> the title and the URL.
>>
>> I hope this gives German a better idea and also hope this is not so hard
>> to implement - after holidays, please let us know if you have any issues
>> German.
>>
>> Thanks also to Nurani for the feedback on the summary.
>> I'm happy to know my understanding is consistent with other members of
>> CRISP team - if anyone has other thoughts/comments, it's still welcome
>> ofcourse.
>>
>>
>> Izumi
>>
>> (2014/12/24 15:56), Andrei Robachevsky wrote:
>>> This is an accurate summary Izumi, thank you.
>>>
>>> Izumi Okutani wrote on 24/12/14 03:16:
>>>>     - Version control of each draft (like in the IETF)
>>>
>>> And I think by that we meant including the version number in the title
>>> and the URL. I current practice is that the name of the file contains
>>> the date. It'd be also useful if we put the date in the document itself.
>>>
>>> Regards,
>>>
>>> Andrei
>>>
>>
>>
>> _______________________________________________
>> CRISP mailing list
>> CRISP at nro.net
>> https://www.nro.net/mailman/listinfo/crisp
>>
>
>
> _______________________________________________
> CRISP mailing list
> CRISP at nro.net
> https://www.nro.net/mailman/listinfo/crisp
>


-- 
______________________
Mwendwa Kivuva, Nairobi, Kenya
twitter.com/lordmwesh

The best athletes never started as the best athletes.
You have to think anyway, so why not think big? - Donald Trump.
"You miss 100 percent of the shots you never take." - Wayne Gretzky.
Tackle the biggest frog first.
I will persist until I succeed - Og Mandino.




More information about the CRISP mailing list