<div id="header-title" style="padding: 10px 15px; border-width:1px; border-style:solid; border-color:#FFD28C; background-image: url(<nop>https://jazz.net/wiki/pub/Deployment/WebPreferences/TLASE.jpg); background-size: cover; font-size:120%"> ---+!! Deployment wiki roles and responsibilities %DKGRAY% Authors: Main.AmyLaird, Main.StevenBeard <br> Build basis: None %ENDCOLOR%</div></sticky> <!-- Page contents top of page on right hand side in box --> <sticky><div style="float:right; border-width:1px; border-style:solid; border-color:#DFDFDF; background-color:#F6F6F6; margin:0 0 15px 15px; padding: 0 15px 0 15px;"> %TOC{title="Page contents"}% </div></sticky> <sticky><div style="margin:15px;"></sticky> The following responsibilities clarify roles for the wiki and ensure that content is reviewed for technical accuracy, adherence to writing guidelines, and the correct location for the information. ---++ Content managers: Community technical leaders and senior editors The [[DeploymentLeaders][community technical leaders and senior editors]] govern and manage the wiki. This leadership team consists of deployment leaders, experts, and senior editors, including all section leads, from IBM and a few customers and IBM Business Partners. This team has the following responsibilities: * Set the [[DeploymentWikiVision][vision]] and strategy for the Deployment wiki. * Build the Rational [[DeploymentWikiVision#DeploymentCommunity][Deployment community]] to support the wiki and other Rational client-facing programs. * Define the governance and management policies for the wiki, including these guidelines: * These roles and responsibilities * [[DeploymentWritingGuidelines][Writing guidelines]] * [[DeploymentExternalLinkingPolicy][External linking policy]] * [[DeploymentGuidanceOnMigratingArticles][Guidance on migrating articles]] * [[DeploymentFormattingGuidance][Formatting guidance]] * Review and approve nominations for membership in the [[DeploymentTechnicalLeadersAndSeniorEditorsNominationProcess][technical leaders and senior editors]] and the [[DeploymentPractitionersNominationProcess][deployment practitioners]] groups. * Manage the [[https://jazz.net/jazz02/web/projects/Deployment%20Wiki#action=com.ibm.team.apt.viewPlan&page=com.ibm.team.apt.web.ui.plannedItems&id=_n26NRpDhEeKcd5Yt6Ydj9g&planMode=com.ibm.team.apt.viewmodes.internal.productBacklog.ranking][backlog]] of proposals for new wiki content. * Maintain the consistency and quality of the wiki content, especially between sections. ---++ Content managers: Section leads These guidelines apply to the designated [[DeploymentLeaders][section leads for the wiki]]. * Coordinate the team, strategy, structure, and population of the assigned wiki section: * Identify existing content to move and new content to add to the wiki section. * Identify authors to add content to the wiki and assign work by using the [[https://jazz.net/jazz02/web/projects/Deployment%20Wiki#action=com.ibm.team.dashboard.viewDashboard][Rational Team Concert project for the Deployment wiki]]. * Inform authors of their roles and responsibilities, and the policies and guidelines for the wiki. * Monitor the content of the wiki section: * Monitor the incoming content to the section. * Ensure that content is current and accurate. * Ensure that content is receiving the appropriate technical reviews. * Address incorrect, outdated, or inappropriate content as a matter of urgency. * Monitor and respond to incoming comments. * Coordinate with the user assistance representative for the section: * Ensure that the [[https://jazz.net/jazz02/web/projects/Deployment%20Wiki#action=com.ibm.team.dashboard.viewDashboard&tab=_3"][user assistance representative]] is aware of incoming content. * Ensure that the user assistance representative is receiving review requests for the content. * Coordinate with the user assistance representative to verify whether content belongs in an information center, in other product documentation, or on the wiki. * Verify that links are established between the information centers and wiki according to the established [[DeploymentExternalLinkingPolicy][linking guidelines for the wiki]]. * Maintain the content of the wiki section: * Each release, review the content to ensure that it is still relevant and up to date and update the topic page's build basis as appropriate. ---++ Authors: Technical leaders and senior editors (Main.TWikiDeploymentAuthorsGroup) These guidelines apply to authors who are identified as [[TWikiDeploymentAuthorsGroup][technical leaders and senior editors]]. * Identify content to add or modify on the wiki. * Verify that the content does not already exist in another location, such as in the information center, on Jazz.net, or on developerWorks. * Verify that the content meets the criteria for the wiki as described in the [[DeploymentWikiVision][Deployment wiki vision]]. * Identify the appropriate [[WebHome][section of the wiki]] to which to add or modify content: * For significant changes, contact the [[DeploymentLeaders][section lead]] by email (email addresses should be available on personal pages, such as Main.StevenBeard) to discuss the proposed content. * Review the [[DeploymentWritingGuidelines][writing guidelines for the wiki]]. * Review the [[DeploymentFormattingGuidance][formatting guidance]] for the wiki. * Write content in accordance with the established [[DeploymentWritingGuidelines][writing guidelines for the wiki]]. * All topic pages that are editable by only technical leaders and senior editors (Main.TWikiDeploymentAuthorsGroup) must use the [[DeploymentFormattingGuidance#StatusIcons][status icon conventions]]. * Ensure that the content is technically accurate: * Through a work item in the [[https://jazz.net/jazz02/web/projects/Deployment%20Wiki#action=com.ibm.team.dashboard.viewDashboard][Rational Team Concert project for the Deployment wiki]], use the Approvals tab to obtain a technical review from a minimum of two people: a subject-matter expert (SME) and the content lead for the wiki section. * Obtain a user assistance review for all content: * Through a work item in the [[https://jazz.net/jazz02/web/projects/Deployment%20Wiki#action=com.ibm.team.dashboard.viewDashboard][Rational Team Concert project for the Deployment wiki]], inform the user assistance (UA) contact for the wiki area that content is available and use the Approvals tab to request a UA review. * After technical and UA reviews, change or remove the under construction icon to show the new status according to the [[DeploymentFormattingGuidance#StatusIcons][status icon conventions]]. * Maintain the wiki content: * Monitor and respond to incoming comments. * For each new release, ensure that the content remains current; apply updates as needed. * Review and maintain links between the wiki and the information center (IC) for each release, in accordance with the established [[DeploymentExternalLinkingPolicy][linking guidelines for the wiki]]. ---++ Authors: Deployment practitioners (Main.TWikiAuthorsGroup and Main.TWikiExternalAuthorsGroup) and Jazz.net users These guidelines apply to wiki contributors from the broader community, including Jazz.net users and members of Main.TWikiAuthorsGroup and Main.TWikiExternalAuthorsGroup. * Identify content to add or modify on the wiki * Verify that the content does not already exist in another location, such as in the information center, on Jazz.net, or on developerWorks. * Verify that the content meets the criteria for the wiki as described in the [[DeploymentWikiVision][Deployment wiki vision]]. * Identify the appropriate [[WebHome][section of the wiki]] to which to add or modify content. * For significant changes, contact the [[DeploymentLeaders][section lead]] by email (email addresses should be available on personal pages, such as Main.StevenBeard) to discuss the proposed content. * You might need the section lead to create a new topic page and set the appropriate level of write access. * Review the [[DeploymentWritingGuidelines][writing guidelines for the wiki]]. * Review the [[DeploymentFormattingGuidance][formatting guidance]] for the wiki. * Draft the content for the wiki. * All topic pages that are editable by deployment practitioners (Main.TWikiAuthorsGroup and Main.TWikiExternalAuthorsGroup) should use the [[DeploymentFormattingGuidance#StatusIcons][status icon conventions]]. * If possible, obtain a technical review from subject matter experts. * After technical review, change or remove the under construction icon to denote its new status in accordance with the [[DeploymentFormattingGuidance#StatusIcons][status icon conventions]]. ---++ Reviewers: User assistance writers These guidelines apply to the [[https://jazz.net/jazz02/web/projects/Deployment%20Wiki#action=com.ibm.team.dashboard.viewDashboard&tab=_3"][IBM user assistance writers]] who are assigned to sections of the wiki. * Periodically review all content in the assigned wiki section. * Copy edit the content in the assigned area based on the established [[DeploymentWritingGuidelines][writing guidelines for the wiki]]. * As time permits, further improve the content quality by applying writing, style, and word usage guidelines. * Investigate and determine where content belongs (on the wiki or in an IC) and coordinate any movement of information. * Review and maintain links between the wiki and the ICs for each release, according to the established [[DeploymentExternalLinkingPolicy][linking guidelines for the wiki]]. ---++ Reviewers: User assistance editors These guidelines apply to the [[https://jazz.net/jazz02/web/projects/Deployment%20Wiki#action=com.ibm.team.dashboard.viewDashboard&tab=_3][IBM user assistance editors]] who are assigned to the wiki. * Establish and maintain the [[DeploymentWritingGuidelines][writing guidelines for the wiki]] * Consult when authors have content, structure, or style questions * Periodically review the wiki content for adherence to the established writing guidelines, ideally toward the end of each release, individual release timing TBD * Coordinate the user assistance review of the wiki by using the [[https://jazz.net/jazz02/web/projects/Deployment%20Wiki#action=com.ibm.team.dashboard.viewDashboard][Rational Team Concert project for the Deployment wiki]] * As time permits, make ad hoc edits to content based on the established writing guidelines for the wiki. ---+++++!! Related topics: * [[DeploymentWritingGuidelines][Writing guidelines]] * [[DeploymentExternalLinkingPolicy][External linking policy]] * [[DeploymentGuidanceOnMigratingArticles][Guidance on migrating articles]] * [[DeploymentFormattingGuidance][Formatting guidance]] ---+++++!! External links: * [[https://jazz.net/jazz02/web/projects/Deployment%20Wiki#action=com.ibm.team.dashboard.viewDashboard][Rational Team Concert project for the Deployment wiki]] ---+++++!! Additional contributors: Main.LauraHinson, Main.RalphEarle <sticky></div></sticky>
This topic: Deployment
>
WebHome
>
DeploymentRolesAndResponsibilities
History: r18 - 2013-08-28 - 11:45:14 - Main.sbeard
Copyright © by IBM and non-IBM contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our
Terms of Use.
Please read the following
disclaimer
.
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more
here
.