Presentation is loading. Please wait.

Presentation is loading. Please wait.

WG Editor’s Meeting (May ‘11)

Similar presentations


Presentation on theme: "WG Editor’s Meeting (May ‘11)"— Presentation transcript:

1 802.11 WG Editor’s Meeting (May ‘11)
July 2007 May 2011 WG Editor’s Meeting (May ‘11) Date: Authors: Peter Ecclesine (Cisco Systems) Peter Ecclesine (Cisco Systems)

2 May 2011 Abstract This document contains agenda/minutes/actions/status as prepared/recorded at the IEEE Editors’ Meeting Peter Ecclesine (Cisco Systems)

3 Agenda for 2011-05-10 Roll Call / Contacts / Reflector
May 2011 July 2007 Agenda for Roll Call / Contacts / Reflector Go round table and get brief status report ANA Status / Process / What is administered Mandatory Editorial Coordination before SB Numbering Alignment process / Spreadsheet Amendment Ordering / Draft Snapshots Style Guide for MIB style and Frame practices (FrameMaker 10.0) Peter Ecclesine (Cisco Systems) Peter Ecclesine (Cisco Systems)

4 Roll Call – 2011-05-10 May 2011 July 2007 802.11 Editor’s Present
P802.11s Amendment (MESH) –Kazuyuki Sakoda P802.11aa Amendment (VTS) – Alex Ashley P802.11ac Amendment (VHT L6) – Robert Stacey P802.11ad Amendment (VHT60) – Carlos Cordeiro P802.11ae Amendment (QosMan) – Henry Ptasinski P802.11af Amendment (TVWS) – Peter Ecclesine P802.11ah Amendment (S1G) – Minyoung Park P802.11ai Amendment (FILS) – Tom Siep Editor’s Not Present P802.11mb Amendment (REVmb) – Adrian Stephens Also present: Clint Chaplin Mike Montemurro Jon Rosedahl IEEE Staff present and always welcome! IEEE Staff not present and always welcome! Kim Breitfelder – manager publishing, Tricia Gerdon – our staff liaison, Michelle Turner – staff editor for 802, Note: editors request that an IEEE staff member should be present at least during Plenary meetings Peter Ecclesine (Cisco Systems) Peter Ecclesine (Cisco Systems)

5 Volunteer Editor Contacts
May 2011 July 2007 Volunteer Editor Contacts TGs – Kazuyuki Sakoda – TGmb – Adrian Stephens – TGaa – Alex Ashley – TGac – Robert Stacey – TGad – Carlos Cordeiro – TGae – Henry Ptasinski – TGaf – Peter Ecclesine – TGah – Minyoung Park – TGai – Tom Siep – Editors Emeritus: TGk – Joe Kwak– TGp – Wayne Fisher – TGr – Bill Marshall – TGu – Necati Canpolat – TGv – Emily Qi – TGw – Nancy Cam-Winget – TGz – Menzo Wentink – Peter Ecclesine (Cisco Systems) Peter Ecclesine (Cisco Systems)

6 Round table status report
REVmb – in Sponsor Ballot comment resolution, hope to recirc 11s – in Sponsor Ballot comment resolution, hope to recirc 11aa – in WG Letter Ballot comment resolution, hope to recirc 11ac – hope to go to WG letter ballot 11ad – in WG Letter Ballot comment resolution, hope to recirc 11ae – in WG Letter Ballot comment resolution, hope to recirc 11af – in WG Letter Ballot comment resolution, hope to go to WG LB after July meeting 11ah – working on requirements, hope to have a draft in March, 2012 11ai – working on use cases and requirements Peter Ecclesine (Cisco Systems)

7 May 2011 July 2007 Reflector Updates Each editor is expected to be on the reflector and current. If you didn’t receive the meeting notice from the reflector, please send to To be updated: None Peter Ecclesine (Cisco Systems) Peter Ecclesine (Cisco Systems)

8 IEEE Publication Status
May 2011 July 2007 IEEE Publication Status Publications completed for k, r and y, n and w 11k now available with Get802 11p now available with Get802 11r now available with Get802 11y now available with Get802 11w now available with Get802 11n now available with Get802 Publication of 11z announced October 21st Publication of 11v announced February 9th Publication of 11u announced March 7th Peter Ecclesine (Cisco Systems) Peter Ecclesine (Cisco Systems)

9 May 2011 July 2007 ANA Announcements Current ANA announced to group is r3. (2011 May 8) See All new requests received by end of meeting will be uploaded and announced via WG reflector Procedure for ANA is contained in 07/0827r0. See Editorial Guidance ANA assignments should be done before the time of moving from WG LB to Sponsor ballot. If a resource number is not in the ANA Database, please use <ANA> in drafts! Editors to replace any ANA controlled resources numbers with <ANA> upon incorporation of material into drafts. Editors need to check the ANA database to determine which resources are controlled and ensure that values are requested from the ANA. Peter Ecclesine (Cisco Systems) Peter Ecclesine (Cisco Systems)

10 ANA Report Recent allocations to TGad (1 item) and TGs (9 items)
Nov 2010 ANA Report Recent allocations to TGad (1 item) and TGs (9 items) Two Behavior Limits released (reserved) by TGmb Two “temporary” values used by TGmb replaced by allocated values Reallocation of two values used by TGmb to avoid collision with published .11v Peter Ecclesine (Cisco Systems)

11 Numbering Alignment Process
May 2011 Numbering Alignment Process Update from all published standards. Posted as 11-08/644r20 (2011 Feb 17) By Kazuyuki Sakoda TGz-2010 started a new update cycle. 11v-2011, 11u-2011, REVmb D8.0 numbering needs to be completed. 11ae is the next, then 11aa, 11af, 11ad, 11ac, 11ah, 11ai. We should start with a 2011 document number. Create a working group MEC that includes numbering and ANA before going to Sponsor Ballot Slide 11 Peter Ecclesine (Cisco Systems)

12 Amendment & other ordering notes
May 2011 Amendment & other ordering notes Editors define publication order independent of working group public timelines: Since official timeline is volatile and moves around Publication order helps provide stability in amendment numbering, figures, clauses and other numbering assignments Editors are committed to maintain a rational publication order Numbering spreadsheet 08/0644: Succeeding amendments to do their respective updates Must match the official timeline after plenaries We are seeing problems in MIB numbering, and say at end of WG LB, our internal MEC insists that the numbering spreadsheet is correct Peter Ecclesine (Cisco Systems)

13 May 2011 MEC Status P802.11s D7.0 has gone through IEEE-SA Mandatory Editorial Coordination in October 2010 See next three slides Working Group MEC 11-11/615r0 documents the process Suggest that TG identify what it expects to be the last WG ballot that will make changes. In parallel with ballot, a team of two editors will review the draft and work with the TG editor to make changes to address: numbering, ANA allocations, adherence to WG style. P802.11ae D5.0 will go through Working Group Mandatory Editorial Coordination before July 2011 Peter Ecclesine (Cisco Systems)

14 11-11/615r0 MEC Review Items May 2011
The following is a list of items that will be included in the 11MEC review Numbering of clauses, subclauses, figures, tables and equations “As best as we can do” to final publication numbering No “private numbering spaces” (e.g., Figure 8-zz1, mib object numbering zz1) Numbering document revised to show correct numbering Numbering of ANA administered objects For all administered ANA namespaces No numbers allocated, except through ANA mechanism No ANA flags All objects to be cross-checked against ANA database MIB Description of MIB variables matches WG style in 11-09/1034 . MIB rolled-in to as much of the base document(s) MIB as possible and any compilation error fixed Every new object exists in a group, and every new group exists in a module-compliance statement. IETF recommendations on type followed. See RFC 4181 ( Compliance to WG style as described in 11-09/1034. Peter Ecclesine (Cisco Systems)

15 Editor’s discussion of 802.11 MEC
May 2011 Editor’s discussion of MEC Eight of nine Task Group editors and others present reviewed and discussed for ~30 minutes 11-11/615r0 WG 11 MEC Process, 11-09/1034r Style Guide, 11-09/533r1 ARC Recommendation re MIB Attribute Types & Usage, and P802.11REVmb Draft 8.0 Annex C.2 Guidelines for MIB authors and editors We found broad agreement on most of the process and requirements, but have three specific recommendations: Cross-references to particular paragraphs in 11-09/1034 Style Guide and 11-11/615 MEC process and particular slides/requirements in other documents should be inserted in text of each. It is hard to assemble the MIB process elements. A strawpoll found zero approve and three disapprove 615r1 MEC Review Item “perfect” numbering of clauses, subclauses, figures, tables and equations The RFC 2578 Management Information (SMIv2) MIB requirements and systems actual management need more discussion among the Working Group. Peter Ecclesine (Cisco Systems)

16 Pre-RevCom IEEE-SA Review
Mar 2010 Pre-RevCom IEEE-SA Review Possibly near the end of Working Group Letter Ballot (3rd recirc or 4th recirc) , we will offer the draft to the publications editor for review. This allows ambiguities and errors to be addressed in Sponsor Ballot by comments, rather than discover the ambiguities and errors after RevCom. It appears that during MEC is the least risky time for a publication editor’s review. TGs Draft 7.0 went to LB166 out of July plenary, and by agreement with ExCom and IEEE SA staff, went for professional editing for ~50 days, (was available mid-October) after which Draft 8.0 will be available for recirculation Sponsor Ballot. That did not work so well, so we will start TGae sooner before going to Sponsor Ballot? Peter Ecclesine (Cisco Systems)

17 Editors page http://www.ieee802.org/11/editor_resources.html
May 2010 Editors page Comments or changes? Very out of date and material scattered across many documents. Volunteers sought to improve this state. Peter Ecclesine (Cisco Systems)

18 802.11 Style Guide See 11-09-1034-01-0000-wg11-style-guide.doc
Editor’s responsibility includes checking the 2009 IEEE Standards Style Manual when creating or updating drafts. Call for interest to update this guide to match REVmb conventions Peter Ecclesine (Cisco Systems)

19 Editor Amendment Ordering
July 2007 May 2011 Amendment numbering is editorial! No need to make ballot comments on these dynamic numbers! Editor Amendment Ordering Data as of May 2011 See Amendment Number Task Group REVCOM Date Amendment 8 TGv Feb 2011 Amendment 9 TGu Amendment 10 TGs Sept 2011 Revision 802.11mb Mar 2012*est. Amendment 1 TGae Jun 2012 Amendment 2 TGaa Amendment 3 TGaf Amendment 4 TGad Dec 2012 Amendment 5 TGac Dec 2013 Amendment 6 TGah July 2013 Amendment 7 TGai Sept 2013 Peter Ecclesine (Cisco Systems) Peter Ecclesine (Cisco Systems)

20 Email Your Draft Status Updates
May 2011 September 2007 Your Draft Status Updates Each editor, please send update for next page via the editor’s reflector no later than Thursday am2 to update table on next page! Peter Ecclesine (Cisco Systems) Peter Ecclesine (Cisco Systems)

21 Draft Development Snapshot
July 2009 July 2007 May 2011 Draft Development Snapshot Most current doc shaded green. Changes from last report shown in red. TG Published or Draft Baseline Documents Source MEC Style Guide Editor Snapshot Date Published s mb ae af aa ad ac ah Y 10.0 Frame 8.0 Yes 2009 Kazuyuki Sakoda 15-Mar 8.0 Frame 9.0 Adrian Stephens 6.0 2.0 OpenOffice 3.2 No Henry Ptasinski 19-Jan 6.02 1.0 Peter Ecclesine 7.0 0.06 4.0 Word Alex Ashley 16-Mar Word 2007 Carlos Cordero 0.2 Robert Stacey Wongyu Song ai Tom Siep Slide 21 Peter Ecclesine (Cisco Systems) Page 21 Peter Ecclesine (Cisco Systems)

22 FrameMaker V9 transition
May 2010 FrameMaker V9 transition Since January 2011, IEEE-SA uses FrameMaker 9.0 exclusively for drafts submitted in FrameMaker editors want to have Visio version of each figure to go into the rollup if the figures are not drawn in Frame. Will work with non-windows editors on their figures. FrameMaker 9.0 is no longer for sale, FrameMaker 10.0 is the current version Peter Ecclesine (Cisco Systems)

23 MIB style, Visio and Frame practices
Mar 2010 MIB style, Visio and Frame practices I’m going to suggest going forward we use a single style with appropriately set tabs,  and use leading Tabs to distinguish the syntax and description parts. (Adrian Stephens Feb 9, 2010)  Keep embedded figures using visio as long as possible Near the end of sponsor ballot,  turn these all into .wmf (windows meta file) format files (you can do this from visio using “save as”).   Keep separate files for the .vsd source and the .wmf file that is linked to from frame. Frame templates for 11aa, 11ac, 11ad, 11af Peter Ecclesine (Cisco Systems)

24 Conference Calls Are they of any value?
Next Meeting: July 17-22, Somewhere in CA Any need for conference calls? Peter Ecclesine (Cisco Systems)

25 Mar 2010 Two Technical Editors Peter Ecclesine will run the face to face meetings Adrian Stephens will run the publication process Adrian Stephens is the ANA administrator All are on the Editor’s list. Peter Ecclesine (Cisco Systems)

26 May 2011 Reference Material Peter Ecclesine (Cisco Systems)

27 Editorial Streamlining
May 2011 July 2007 Editorial Streamlining Focus is on consistency across all TGs: Completed Streamlined ANA processes – 07/0827r0 Consistent format for REDLINE contributions across TGs – 07/0788r0 Consistent process for editorial comment resolution across TGs (WG & Sponsor) – 07/2050r0 Guideline for technical vs. editorial, sample editorial comment responses Format for comment reporting across TGs (WG & Sponsor) – 07/1990r0 (tool in 07/2116r0) Stable numbering method (See 07/2810r0) Consistent naming of redlines (See 07/2810r0) Draft templates for FRAME (no Word) to help train new editors more rapidly Under Construction (in priority order) Revise the editor’s guideline – comments on 09/1034? Mentoring program – Name a mentor for each new editor MIB element numbering and compiling – publish a rolled-up MIB of k/r/y Guideline on non-technical front matter Guideline describing expected editorial development and maturity of draft through stages in for consistency across TGs Guidelines for primitives – ARC to consider Peter Ecclesine (Cisco Systems) Peter Ecclesine (Cisco Systems)

28 Numbering of Annexes and Clauses
May 2011 July 2007 Numbering of Annexes and Clauses Proposal: TGMb will fix the ordering of annexes Ample bad precedent set by 11k Bibliography should be the first or final annex per IEEE Standards Style Guide Clause numbering has similar issue during rollup TGn clause 3a, 11r clause 11a, 11y clause 11.9a REVmb numbering will stay using “Amendment style” numbering until the very last possible moment before going to Sponsor Ballot. Peter Ecclesine (Cisco Systems) Peter Ecclesine (Cisco Systems)

29 Draft naming convention
May 2011 Draft naming convention Drafts and redlines are .pdf files Syntax: Draft <project>_<draft> [Redline [Compared to <project>_<draft>]].pdf Examples: Draft P802.11n_D8.0.pdf Draft P802.11n_D8.0 Redline.pdf Draft P802.11n_D7.04 Redline Compared to P802.11n_D7.03.pdf Please use this convention for all drafts posted on the website. Peter Ecclesine (Cisco Systems)

30 Lessons Learned from RevCom
During Sponsor ballot… (see 09/1058r1) Minimise cross references (“disagree – see CID 1234”) Because not all CIDs are included in the “unsatisfied comments” listing, so this may end up a dangling reference. Copy resolution + add (“same as resoution for CID 1234”) Provide full URLs for doc references Because some members of RevCom and the Sponsor Pool may not be familiar with how to get to Mentor Minimise use of doc references Cut and paste from reference doc, where-ever possible. This minimises work for sponsor ballot members getting reference documents. Easier to audit process Peter Ecclesine (Cisco Systems)

31 May 2011 July 2007 Publication Work Plan Note: to be included in the editor’s operations manual Here is the workflow we have used for a number of years with IEEE staff on publication of publications:  Editors provide FRAME source and any freestanding graphics (Powerpoint, Visio. TIF) to staff at time of REVCOM submission. Editors provide a list of requests editorial corrections no later than REVCOM approval date. Staff prepares a publication draft and highlights changes they have made and questions they need addressed or confirmed. This draft is sent to Task Group Editor and the Working Group Technical Editor (me). This typically occurs about 2-3 weeks after approval for publication, since the preparation work is usually (but not always) begun ahead of approval. This is also typically the draft peer reviewed by IEEE staff. The Task Group Editor responds to all questions on domain specific questions, with copy to Working Group editor (me). This typically takes about 3-5 days. The Working Group Technical Editor reviews responses from the Task Group editor, completes any responses, and provides a list of WG officers and voting members valid for the document as of the opening day of the Sponsor ballot. This typically only takes one additional day from the prior step as most of the work is done in parallel by the two editors. Final draft is submitted by the IEEE staff to Working Group Technical Editor and Task Group Editor for sign-off. Any changes from the responses or IEEE peer review are highlighted and explained. This typically takes only one or two days more after the responses are received from the editors. Task Group Editor gives final approval. No changes are expected. This usually occurs within 24 hours. Working Group Technical Editor signs off and provides draft to Working Group Chair. No changes are expected. This usually occurs within 24 hours and in parallel with the previous step. Working Group Chair sends to sponsor and IEEE staff letting them know the Working Group has signed off on the publication process. Peter Ecclesine (Cisco Systems) Peter Ecclesine (Cisco Systems)

32 Terry Cole on Changes to MIB elements
May 2011 Terry Cole on Changes to MIB elements You can incrementally add to a MIB element without deprecation at any level. That is, add new values and meaning pairs. You can change the description of a MIB element without deprecation at any level. That is add new text clarifying or even changing the meaning of the element to keep up with the standard. I would advise deprecation when changing the definition of some value of a MIB from one thing to another. However, I don't know of any rules requiring this. Peter Ecclesine (Cisco Systems)

33 Publications: lessons learned
May 2011 Publications: lessons learned When quoting baseline text inaccurately, the baseline text is changed whether or not the changes were marked. The IEEE staff will actually do the appropriate changes as if the task group had actually intended to change the baseline. Drafts can minimally quote baseline text to minimize such changes Should revisit the decision to include full context during insertion Full Annex titles have to be shown in the amendment; more importantly included “normative” vs. “informative” TGk inadvertently changed Annex A to be fully informative TGr battled to fix Annex A but caused ripples TGy r1 has brief review of significant things changed for publication In editor’s operations manual and during balloting, should comment that Annexes should be fully titled with good reason to vote “No” in balloting Slide 33 Peter Ecclesine (Cisco Systems)

34 Publications: lessons learned (cont’d)
May 2011 Publications: lessons learned (cont’d) Acronym rules are inconsistent Styleguide doesn’t include definitions Every document is treated as standalone, thus first acronym reference must be spelled out. Even though, other amendments or baseline may have defined and used the acronym earlier. Goal should be to have as few changes between the final balloted amendment and final published amendment. How do we deal with subjective decisions made by the IEEE copy editors as their styles vary? Booleans should be capitalized: TRUE and FALSE when “set to” Booleans should be lower case: is true and is false (raise the issue with Style Guide update) Slide 34 Peter Ecclesine (Cisco Systems)

35 Pre-RevCom IEEE-SA Review
Mar 2010 Pre-RevCom IEEE-SA Review Adrian: not sure we need this slide Possibly near the end of Working Group Letter Ballot (3rd recirc or 4th recirc) , we will offer the draft to the publications editor for review. This allows ambiguities and errors to be addressed in Sponsor Ballot by comments, rather than discover the ambiguities and errors after RevCom. It appears that during MEC is the least risky time for a publication editor’s review. TGs Draft 7.0 went to LB166 out of July plenary, and by agreement with ExCom and IEEE SA staff, went for professional editing for ~50 days, after which Draft 8.0 will be available for recirculation Sponsor Ballot. Our experience with this process led us to have an MEC by our Technical Editor Peter Ecclesine (Cisco Systems)


Download ppt "WG Editor’s Meeting (May ‘11)"

Similar presentations


Ads by Google