Help for Setting Up an Approval Ballot on NENA Workspace: Difference between revisions

Updated after draft was reviewed for 30 days.
(→‎To choose the document for an Approval Ballot:: Added spaces back for some Template:Step)
(Updated after draft was reviewed for 30 days.)
 
Line 1:
== Document Approval Ballot ==
A NENA "Consensus Body" is made up of the voting members of the Working Group that creates and modifies NENA documents. Consensus Bodies use the NENA Workspace (NWS) Approval Ballot to approve documents. This page describes how Working Group leaders can configure an Approval Ballot in NWS.
 
=== Roster Management ===
Successful Approval Ballots require a well-managed roster. Working Group leaders should review their roster on a regular basis and always before an Approval Ballot is opened. The primary concerns in Roster Management are active participation and Interest Category balance, especially if the document is a Standard due to American National Standards Institute (ANSI) requirements. More information on Interest Category can be found in the [https://kb.nena.org/wiki/NENA_Development_Group_Guide NENA Development Guide], in the [https://kb.nena.org/wiki/NENA_Development_Group_Guide#How_to_Add_Member_in_NENA_Workspace_to_a_Working_Group How to Add Member in NENA Workspace to a Working Group] section. Additional information on Openness and Balance is available in the NENA Development Group Organizational Structure and Operational Procedures, in the Openness and Balance section of NENA-ADM-001.
 
==== Active Participation ====
Persons who have not been participating in the group’s activities, such as attending calls, responding to ballots, contributing material, and engaging in email discussions, should be contacted about their lack of participation, and may be removed in NENA Workspace or changed to an Authorized Observer.
 
To remove a Working Group member, simply:
 
# Go to '''Settings''' (gear icon).
# Select '''Members''' under Administration.
# Select the drop-down arrow next to '''Edit Roles''' to the far right of the person’s name you are removing and select '''Remove'''.
# Send an email to the CRM at [mailto:crm@nena.org crm@nena.org] so the individual may be deactivated in NENA Workspace if they are not a member of any other Working Group.
 
See [https://kb.nena.org/wiki/NENA_Development_Group_Guide#How_to_Remove_a_Member_From_a_Working_Group_or_Change_their_Status_to_an_Authorized_Observer How to Remove a Member From a Working Group or Change their Status to an Authorized Observer] for details and [https://kb.nena.org/wiki/Working_Group_Member_Attendance_Notice Working Group Member Attendance Notice] for a suggested email to send.
 
==== Interest Category Balance ====
Interest Category Balance should be managed throughout the Working Group existence as members are added or removed by a Group Leader. A Working Group member's Interest Category is typically classified in accordance with the business or other interests of their employers they represent in connection with the standards development activity.
 
Line 34:
*All Authorized Observers and DSC Leadership should reflect the 3 dashes as their Interest Category.
*(Sort spreadsheet by Organization) If an Organization has a Primary Voter and one or more alternates, make sure they all reflect the same Interest Category.
* (Sort by voting level) Move all Authorized Observers, DSC Leadership, and Alternate Voters further down in the spreadsheet and make a header called NON-VOTERS.
*Those remaining at the top of the spreadsheet should reflect one (1) Primary Voter per Organization --- this is your Consensus Body.
* Take this group and sort by Interest Category --- with a goal that each group should be no more than 1/3 of the total (with one Interest Category not being 50% or more).
Another method to determine WG Balance is using the [https://dev.nena.org/higherlogic/ws/groups/ed9b432e-644e-48be-ab9f-c8cffce3a079/documents/forms130/document?document_id=28202 TEMPLATE_WG_Attendance_20230122] spreadsheet, WG Balance tab. The WG Balance tab is pre-configured to provide the percentage of each Interest Category based on the Interest Category assigned to the WG member in NWS and the roster. Interest Categories can then be changed in the spreadsheet to balance the WG.
 
Line 48:
Documents to be approved are uploaded to the Documents section of a Working Group's Workspace tab. Documents for approval are placed in the folder (e.g., Draft WG Documents, Public Review) at the current state (e.g., WG Draft, Public Review) of the document in the development process. The states of a document are defined as the following:
 
* '''Draft WG Document''' – a document that is in draft, or has been drafted, by the Working Group. A Draft WG Document will migrate to the next step of the approval process upon approval by the Working Group through the WG Approval Ballot process.
*'''All Committee Review''' – a draft document that has received approval from the Development Steering Council (DSC) and is distributed for review by the NENA Development Group membership.
*'''Public Review''' – a draft document that has received approval from the DSC and is distributed for review by the NENA Development Group, NENA membership, and the public. Depending on whether comments are received, and the types of changes made as a result, the document may experience iterative Public Reviews.
*'''NENA Board Approval''' – a draft document that has received approval by the NENA Board of Directors to publish as a NENA document.
*'''ANSI Approval''' – a draft document that has received an ANSI approval to publish as an American National Standard (ANS). Note: This state is restricted to STA documents that have received an approved Project Initiation Notification System (PINS).
* '''Published''' – a final document that has been approved for publication by the NENA Board of Directors and as applicable, ANSI.
 
Please see the [https://kb.nena.org/wiki/Process_Flow_Chart_for_STA,_REQ,_INF_Documents Process Flow Chart for STA, REQ, INF Documents] for more information on the steps associated to the document development process. It is important to note that the process requirements, and the document state(s), may be different based on the type of document that is being developed. Additional guidance can be obtained by contacting the CRM at [mailto:crm@nena.org crm@nena.org].
Line 85:
[[File:Select Workspace Tab 2021-02-02 10-39-58.png|alt=Select Workspace Tab|650x650px]]
 
Click on '''Documents''' {{Step|Step=1}}, the Folder Navigator {{Step|Step=2}}, and then the folder where the document is {{Step|Step=3}}.
 
[[File:Select Folder with Review Document 2023-05-17 12-01-37.png|alt=Select folder with review document.]]
Line 106:
The default language starts with Approval and includes the name of the document selected for the vote. (e.g., Approval NENA-INF-050.1-202Y_References_PubRvw_20230327_forBallot)
 
The ballot creator should <u>modify the title</u> to add “for advancement to <phase> Review” to the end of the title. The following is an example.
 
'''Example''': Approval of NENA-INF-050.1-202Y_References_PubRvw_20230327_forBallot for advancement to Public Review
Line 119:
The default language starts as a question and includes the name of the document selected for the vote. (e.g., Should NENA-INF-050.1-202Y_References_PubRvw_20230327_forBallot be approved?)
 
The ballot creator should <u>modify the question</u> to add “for advancement to <phase> Review” to the end of the question. The following is an example.
 
'''Example:''' Should the NENA-INF-050.1-202Y_References_PubRvw_20230327_forBallot be approved for advancing to Public Review?
Line 125:
'''Description'''
 
The Description clarifies the result of a '''Yes''', '''No''', or '''Abstain''' vote. AsThe well,Description languagealso isincludes includedlanguage to reinforce the requirement for Primary Voters to vote and a link to a help page for completing the ballot and submitting a comment. Here is how to fill in the Description:
 
# In the '''Description''' dialog box, click on '''Source'''.
'''Recommended Text:''' <blockquote>A '''Yes''' vote signifies you approve advancing the document for Public Review.
# Delete any code in the '''Description''' box, then copy and paste the '''Recommended Description HTML Text:''' (below) into the '''Description'''.
# Click on '''Source''' again to see the formatted text.
 
'''Recommended Description HTML Text:'''
A '''No''' vote signifies you do NOT approve of advancing the document for Public Review. Note that a comment is REQUIRED that explains why you voted not to advance the document.
 
'''Recommended Text:''' <syntaxhighlight lang="html"><blockquotep>A '''<strong>Yes'''</strong> vote signifies you approve advancing the document for Public Review.</p>
Eligible voters have the option to cast a vote of '''Abstain'''. 
 
<p>A '''<strong>No'''</strong> vote signifies you do NOT approve of advancing the document for Public Review. Note that a comment is REQUIRED that explains why you voted not to advance the document.</p>
It is a NENA requirement that eligible WG members MUST vote ('''Yes''', '''No''', or '''Abstain''') in all ballots presented to them.</blockquote>Example of these completed ballot fields:
 
<p>Eligible voters have the option to cast a vote of '''<strong>Abstain'''</strong>. </p>
 
<p>It is a NENA requirement that eligible WG members MUST vote ('''<strong>Yes'''</strong>, '''<strong>No'''</strong>, or '''<strong>Abstain'''</strong>) in all ballots presented to them.</blockquotep>Example of these completed ballot fields:
 
<p><strong><u>NOTE:</u> See <a href="https://ndgkb.nena.org/wiki/Help_for_Voting_on_a_Ballot" target="_blank">Help for Voting on a Ballot</a> for help on completing the ballot and submitting an associated comment.</strong></p></syntaxhighlight>
Example of these completed ballot fields:
 
[[File:Description 2023-05-09 17-14-51.png|alt=Screen Print: Example of Description|800x800px]]
Line 147 ⟶ 156:
[[File:Passing Percentage 2023-05-09 17-17-06.png|alt=Screen Print: Passing Percentage]]
 
==== '''Opening and Closing Dates and Timezone'''====
An Approval Ballot is required to remain open for 10-business days. The ballot can be extended beyond the 10-business days; however, it cannot be shorter.
 
Line 163 ⟶ 172:
'''Do NOT complete this section.''' All fields are to remain blank. NENA allows for everyone to vote regardless of attendance.
 
===== '''Voter Management'''=====
It is recommended that the only voting members are those Working Group members who joined prior to the vote being placed. Should a WG member join while there is an active ballot, the WG Co-Chair should either hold off on adding them to the Working Group or, if added, add them as an Authorized Observer to not skew the vote.
 
Line 170 ⟶ 179:
[[File:Voter Management 2023-05-09 17-20-35.png|alt=Screen Print: Voter Management|800x800px]]
 
====Optional Configuration ====
The Approval Ballot can be used for both official and non-official ballots. An official ballot is a ballot that is supporting the document management process. An unofficial ballot is a ballot that is more informative such as establishing a new working group meeting time and day.
 
Line 176 ⟶ 185:
When “Create Approval Ballot” was selected to create the ballot, the default is a checkmark indicating that it is an official ballot. If it is an unofficial ballot, click to remove the checkmark.
 
=====Commenting Permissions on Approval Document =====
The commenting permissions selection determines who can add comments. As a Working Group Approval Ballot, both the '''Comments can be added by''' and the '''Comments can be viewed by''' should be set to '''Document Viewers'''.
 
Line 186 ⟶ 195:
[[File:Revoting Support 2023-05-09 17-22-44.png|alt=Screen Print: Revoting Support|800x800px]]
 
===== Related Projects=====
If the document is an ANS candidate document, it will have a Related Project. Select the project name, and '''Add'''.
 
Line 196 ⟶ 205:
[[File:Add Reference Items 2023-05-09 17-26-32.png|alt=Screen Print: Add Reference Items]]
 
==== Ballot Results====
The Ballot Results section allows the ballot creator the ability to allow others visibility to the voting process as votes are placed. The default is for the '''Members of the Group''' to have visibility, indicated by the checkmark. The defaults for '''Results Availability''' (“Available as soon as the ballot opens”) and '''Results Style''' (“Show a detailed list of voters and their votes”) allows the most visibility to the voting process. It is recommended to use the default settings.