--
Take care:
Dr. David Snelling < David . Snelling . UK . Fujitsu . com >
Senior Research Fellow / Fujitsu Distinguished Engineer
Fujitsu Laboratories of Europe Ltd.
+44-7590-293439 (Mobile)
From: matt Reed [mailto:matt.reed.uk@gmail.com]
Sent: 25 April 2017 20:16
To: Snelling, David <david.snelling@uk.fujitsu.com>
Cc: coel@lists.oasis-open.org
Subject: Re: [coel] FW: OASIS Editor's Manual -- Request for Feedback
Some first thoughts:
[1] A single coherent document is a good endpoint, but splitting this into individual pieces at the start was a good "divide and rule" tactic as it kept track changes managable and different folks on the TC, with different levels of expertise
and interest in the different parts, could "hold the pen" for the individual pieces. The merge allowed anotehr level of review on overall coherence.
[2] Having a "best practice" final structure was a real help - we used the TOSCA YAML but perhaps there are others. Perhaps OASIS has only 3 or 4 different types of specification so a new TC could use the best practice document that was
closest to their expected needs.
[3] Weekly calls help drive progress (this feels like an agile approach - the artefact is the work in progress, no prep or update presentations, keep managing the backlog on the issues log).
[4] Having a clear idiots guide to what normative means and how to segment normative from non-normative material would help.
[5] Having a specification "mentor" for the TC from OASIS itself would help - although the TC must own the content and technical specs, a mentor could help guide the process of creation and editing.
Best wishes
Matt
On Tue, Apr 25, 2017 at 1:03 PM,
david.snelling@uk.fujitsu.com <david.snelling@uk.fujitsu.com> wrote:
Guys,
Let's see if we can help. We learned a lot in going from novice to (well almost) pro standards writers. Passing on that experience might be a good idea.
Let's add this to the agenda on Friday.
--
Take care:
Dr. David Snelling < David . Snelling . UK . Fujitsu . com >
Senior Research Fellow / Fujitsu Distinguished Engineer
Fujitsu Laboratories of Europe Ltd.
+44-7590-293439 (Mobile)
> -----Original Message-----
> From: Kevin Mangold [mailto:kevin.mangold@nist.gov]
> Sent: 24 April 2017 16:54
> To: Snelling, David <david.snelling@uk.fujitsu.com>
> Subject: OASIS Editor's Manual -- Request for Feedback
>
> David,
>
> I am contacting you on behalf of the OASIS Technical Advisory Board (TAB).
> We are putting together a manual that new and existing editors can use to
> facilitate development of their respective project(s). We are hoping that
> your experience as a TC Chair that you would be able to help provide some
> feedback (this email is only going out to TC Chairs and Secretaries -- you may
> wish to forward this to your TC for further discussion).
>
> If you could provide a couple of items/topics you would think would add
> value to this manual, that would be fantastic! Also, any tips or tricks you or
> your TC has learned through its own development is helpful, too.
>
> Thank you and your help is much appreciated!
>
> Kevin Mangold
>
>
Unless otherwise stated, this email has been sent from Fujitsu Services Limited (registered in England No 96056); Fujitsu EMEA PLC (registered in England No 2216100) both with registered offices at: 22 Baker Street, London W1U 3BW; PFU (EMEA) Limited, (registered in England No 1578652) and Fujitsu Laboratories of Europe Limited (registered in England No. 4153469) both with registered offices at: Hayes Park Central, Hayes End Road, Hayes, Middlesex, UB4 8FE.
This email is only for the use of its intended recipient. Its contents are subject to a duty of confidence and may be privileged. Fujitsu does not guarantee that this email has not been intercepted and amended or that it is virus-free.
---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail. Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
Unless otherwise stated, this email has been sent from Fujitsu Services Limited (registered in England No 96056); Fujitsu EMEA PLC (registered in England No 2216100) both with registered offices at: 22 Baker Street, London W1U 3BW; PFU (EMEA) Limited, (registered in England No 1578652) and Fujitsu Laboratories of Europe Limited (registered in England No. 4153469) both with registered offices at: Hayes Park Central, Hayes End Road, Hayes, Middlesex, UB4 8FE.
This email is only for the use of its intended recipient. Its contents are subject to a duty of confidence and may be privileged. Fujitsu does not guarantee that this email has not been intercepted and amended or that it is virus-free.