Edit
Attach
P
rintable
r15 - 2013-05-13 - 10:49:29 - Main.sbeard
You are here:
TWiki
>
Deployment Web
>
DeploymentRolesAndResponsibilities
<sticky><div id="container" > <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 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][RTC 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][RTC 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][RTC 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][RTC 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][RTC project for the Deployment wiki]] ---+++++!! Additional contributors: Main.LauraHinson, Main.RalphEarle <sticky></div></div></sticky>
Edit
|
Attach
|
P
rintable
|
V
iew topic
|
Backlinks:
We
b
,
A
l
l Webs
|
H
istory
:
r18
<
r17
<
r16
<
r15
<
r14
|
More topic actions...
Deployment
Deployment web
Planning and design
Installing and upgrading
Migrating and evolving
Integrating
Administering
Monitoring
Troubleshooting
Community information and contribution guidelines
Create new topic
Topic list
Search
Advanced search
Notify
RSS
Atom
Changes
Statistics
Web preferences
NOTE: Please use the Sandbox web for testing
Status icon key:
To do
Under construction
New
Updated
Constant change
None - stable page
Smaller versions of status icons for inline text:
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
.