RE: [tag] The Update Process

["Durand, Jacques R." <JDurand@us.fujitsu.com>]

Thanks Stephen: that looks much better...

About proposed updates to the draft: 

From now on, proposed updates must follow a process a bit more rigorous,
as we mentioned in a recent meeting:

1. the proposed update is submitted as an "guideline-related issue
(GRI)" 
That should be done on the wiki at the:
 "Documents (work in progress) / Guideline-related issue" section:
http://wiki.oasis-open.org/tag/DocIssues
You have to pick an issue # for your new issue.
Because we have now a "wiki copy" of the draft, you can IN ADDITION
annotate the wiki to show the proposed change (must be distinguished
from the rest of the text, e.g. by using pseudo tags with issue# in
them, like "<gri123>, so that we can search them)

2. In meetings, the TC approves, or rejects, proposals for open issues.

3. Then only the editor (you) can report the proposed update in the
draft in progress. As long as the issue proposal does not appear in a
draft that has been voted by the TC, the issue status remains "pending"
in the wiki. The editor turns the status to "closed" when the TAG draft
is voted as the next CD ("committee draft")

That's the way many others TC do - a bit buraucratic but prevents
potential confusion / misunderstandings / arguments as what has been
decided and what has not...

Jacques


-----Original Message-----
From: stephen.green@systml.co.uk [mailto:stephen.green@systml.co.uk] 
Sent: Friday, February 08, 2008 12:50 AM
To: tag@lists.oasis-open.org
Subject: Re: [tag] Some TAG Editorial/Admin Notices

Wiki now updated with 'living document' version of draft 0.6++ which
will become the next draft once it has reached an appropriate stage.
Please either 1. make updates on wiki or 2. send updates to list (I will
edit and add to wiki) or 3. send issues to list (I or one of us will add
to issues list on wiki)

http://wiki.oasis-open.org/tag/TestAssertionGuidelines

Best regards

--
Stephen D. Green

Partner
SystML, http://www.systml.co.uk
Tel: +44 (0) 117 9541606

http://www.biblegateway.com/passage/?search=matthew+22:37 .. and voice



Quoting stephen.green@systml.co.uk:

> Just to mention that when I've completed some agreed changes to the 
> draft Guidelines I plan to post a copy of the text on the wiki as a 
> 'living' draft which anyone in the TC may go and update (judiciously 
> of course). If people post me proposals for change which are not 
> controversial I will add those changes too.
>
> So if you see some text which isn't clear and you can improve then do 
> feel free to update on this online wiki draft version.
>
> Then, at some point when there are enough changes to warrant a further

> draft, I will create a new draft and increment the draft version. The 
> wiki version will just be called draft 0.x as the .x will change as 
> either a minor increment (0.x.1, etc) or major increment according to 
> how substantial the changes appear to be.
>
> Plenty of changes were agreed at the schedule A meeting and maybe some

> more will be added at the schedule B part of the meeting too - so much

> review of the changes may be needed when I've updated the draft (soon 
> I hope).
>
> Another administrative point to note:
> For those who are TAG TC observers, since their input is required by 
> OASIS to go through the TAG comment list (so as to allow a respective 
> IPR declaration for submitted comments, as far as I understand it) 
> then their comments will not be seen by TC members unless members also

> subscribe to the tag-comment list (or periodically check the comment 
> archive which has a link on the TC home page).
>
> Anyone may subscribe to the comment list, I believe. To do so just 
> follow the instructions at 
> http://www.oasis-open.org/committees/comments/index.php?wg_abbrev=tag
> I will do so myself so that if observers or any non-members wish to 
> send editorial comments or TAG additions to the list and the TC agrees

> I can add these to the wiki or draft.
>
> I'll also keep a look out for issues for the wiki if posted to comment

> or TC list and add these to the wiki issues page.
> We can all update the issues page anyway of course.
>
> Best regards
>
> --
> Stephen D. Green
>
> Partner
> SystML, http://www.systml.co.uk
> Tel: +44 (0) 117 9541606
>
> http://www.biblegateway.com/passage/?search=matthew+22:37 .. and voice
>
>
>
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe from this mail list, you must leave the OASIS TC that 
> generates this mail.  You may a link to this group and all your TCs in

> OASIS
> at:
> https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php




---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail.  You may a link to this group and all your TCs in
OASIS
at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php