Documentation Procedures

Owned by Former user (Deleted)
Last updated: Jun 07, 2016
3 min read

The purpose of this page is to provide WG / DG leadership with a helpful "how-to" summary guide of the Document Development process as defied by the Operating Procedures that is the authoritative controlling document. The Kantara Support Team is at your service should there be questions regarding application of the process.

 

Types of Output

Work Groups (WG) may create

  • Recommendations (Recommendations may be designated as a Framework or Technical Specification)
  • Reports

Discussion Groups (DG) may create 

  • Reports

Develop a Recommendation

Summary: Initial Draft > Draft Recommendation > Public and IPR Review > LC Certify > All Member Ballot > Final Recommendation

  1. The WG creates a draft work item.  For purpose of identification we can call this the initial draft recommendation
  2. Once the initial draft has reached reasonable maturity the WG shall:
    1. Vote to approve the initial draft as a Draft Recommendation. 
    2. Requirement: Simple Majority of the WG voting members. 
    3. The WG may approve as many internal WG iterations of the Draft Recommendation as they see appropriate. 
  3. Once the WG feels the Draft Recommendation is ready to move to a Final Recommendation status, or in the case the WG seeks broader comments and input, the WG shall:
    1. Vote to approve the Draft Recommendation for public comment and IPR review toward a Final Recommendation status. 
    2. Requirement: Simple Majority of the WG voting members. 
    3. Upon WG approval WG leadership works with the Kantara support team to announce the public comment and IPR review. 
    4. When the public comment and IPR review period is over the WG shall:
      1. Dispose of all comments collected
      2. The WG is not required to implement all comments.
      3. The WG is required to document that each comment has been reviewed and any action agreed upon.
  4. Once the public comment and IPR review process is complete the WG shall:
    1. Vote to approve the Draft Recommendation for LC certification toward All Member Ballot
    2. Requirement: Simple Majority
    3. Upon WG Approval the WG Chair shall:
      1. Notify the LC
      2. Provide the latest draft(s)
      3. Provide reference to disposition of comments
      4. Request LC to certify for All Member Ballot

Develop a Report

Summary: Initial Draft > Draft Report > LC Ratify > Final Report

  1. The WG/DG creates an initial draft. For the purpose of identification we can call this the initial draft report.
  2. Once the initial draft report has reached reasonable maturity the WG/DG shall
    1. Vote to approve the initial draft as a Draft Report
    2. Notify the LC of the Draft Report Approval
    3. Upon notification the LC shall:
      1. Review the report for consistency with the Operating Procedures
      2. Make recommendations to the WG/DG
      3. Approve the Report as Final.
      4. Requirement: Simple Majority

IPR Review

  1. When a WG approves a Draft Recommendation toward Final status approval an IPR Review is necessary. 
  2. Requirement: 45 calendar days
  3. Distribution: community (at) kantarainitiative.org & all (at) kantarainitiative.org
  4. Only WG Participants (listed on the WG Roster) are eligible to make IPR Necessary Claims
  5. Kantara Support Team will craft the notice and distribute as appropriate
  6. NOTE: The public review notice and the IPR notice are enclosed in ONE notice to stakeholders. 

Public Comments

  1. When a WG approves a Draft Recommendation toward Final status approval a public comment review is necessary. 
  2. Requirement: 45 calendar days
  3. Distribution: community (at) kantarainitiative.org & all (at) kantarainitiative.org
  4. Anyone from the general public may submit comments via the Kantara comment form or via email to the Kantara Support Team
    1. Kantara Support Team will collect any comments submitted, treat them for privacy protection as appropriate, and send them to the WG
    2. The WG is required to keep a record of all comments for a disposition of comments at the close of the review. 
    3. The WG is NOT required to incorporate every comment but rather to record that each was heard and any action agreed upon.
  5. Kantara Support Team will craft the notice and distribute as appropriate
  6. NOTE: The public review notice and the IPR notice are enclosed in ONE notice to stakeholders. 

All Member Ballot

  1. The Draft Recommendation must have:
    1. Been made available for public and IPR review for 45 days
    2. All comments must have been recorded and addressed
    3. Been approved toward Final status by the WG
  2. The LC then votes to certify the Draft Recommendation for All Member Ballot to ratify as Final.
    1. Requirement: Simple Majority
  3. Kantara Support Team will draft the ballot (using survey monkey)
  4. Upon WG Chair review and Approval Kantara Support Team notifies the Membership of open eBallot
    1. Time Requirement: Minimum of 14 days
    2. Quorum Requirement: At least 15% of the Membership must participate for eBallot validity
    3. Threshold Requirement: Super Majority of those who participate in the ballot
  5. When the eBallot is closed the Kantara Support Team shall list the results on the All Member Ballots page

 

Reference: Operating Procedures - Kantara Initiative Inc.