constantchange.png Deployment wiki FAQ

Authors: StevenBeard
Build basis: None

Planning and management

Q: When do we go live?

A: The planned go live date will be the 7th May 2013 (see Work item 84675).

Q: What is the communication plan?

A: See Work item 84778.

Access control (see also Deployment wiki access control)

Q: How do we get access for the larger IBM audience to review our pages for technical content?

A: The Deployment wiki request write access for IBMers topic gives guidance on how individual IBMers can request read access before we go live and TWikiAuthorGroup level write access subsequently (see Deployment wiki access control).

Q: If a potential technical reviewer is outside of Rational and does not have a jazz.net login, can they still read our pages?

A: Yes. Once we go live, read access will be unrestricted and not require login with a jazz.net user id.

Q: How do customers make comments once these pages go live?

A: You can add a questions / comments box at the very bottom of any page you would like feedback on (see Deployment formatting guidance).

Editing and formatting

Q: Does the WYSIWYG editor work?

A: There seem to be issues using the WYSIWYG editor (see Work item 81328). Please use the Raw "Edit".

Q: What parts of the pages are editable?

A: Please see the Deployment wiki formatting guidelines for guidelines on use of the topic page template for the Deployment wiki.

Q: Can we remove the default list of authors (it appears anyway at the top right)?

Concern: Folks are confused by this, the authors seem not to be who actually edited the page. Plus there are too many of them. Can we use groups as authors? For each area can we use a standard Group name which would point to a page with our actual names?

A: No. The last editor that appears top right and the history do not necessarily reflect who has made significant contributions to a topic page. A key aim of the wiki is to ensure that authors and additional contributors are recognized for their contribution, both internally to their organization and within the wider community. The authors listed in the title banner for a topic page should reflect those that have made major contribution to developing the page, regardless of who has edited the actual wiki page itself. The number of authors should be kept to a reasonable number (4- 10 max). If a Section/Sub-Section Team have all been instrumental in developing a page you could use a link to the respective section/sub-section e.g.

 [[DeploymentPlanningAndDesign][Deployment planning and design team]] 

Q: Can we remove the Additional Contributors section at the bottom of the page?

Concern: Folks are confused by this too, seems to take needed real estate.

A: No. Again it is important to recognize the efforts of additional contributors to a topic page. A team could be recognized, but there is no problem having a long list of additional contributors as the list is at the bottom of the page. However, to be listed as an additional contributor you should have made an important contribution to a page.

Q: Why is the left menu at the bottom and no longer at the top right?

A: Check to be sure there are two closing div tags at the very end of the editing window.

 <sticky></div></div></sticky> 

Related topics: Deployment wiki access control, Deployment wiki formatting guidance

External links:

Additional contributors: None

Questions and comments:

Warning: Can't find topic Deployment.DeploymentFAQComments

This topic: Deployment > WebHome > DeploymentFAQ
History: r21 - 2013-05-11 - 13:54:12 - Main.sbeard
 
This site is powered by the TWiki collaboration platformCopyright © 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.