[jbosstools-issues] [JBoss JIRA] (JBDS-4220) Installation Guide peer review
Gemma Sheldon (JIRA)
issues at jboss.org
Mon Dec 12 00:17:00 EST 2016
Gemma Sheldon created JBDS-4220:
-----------------------------------
Summary: Installation Guide peer review
Key: JBDS-4220
URL: https://issues.jboss.org/browse/JBDS-4220
Project: Red Hat JBoss Developer Studio (devstudio)
Issue Type: Bug
Reporter: Gemma Sheldon
Priority: Minor
General peer review stuff from the JBDIS Installation Guide.
*Chapter 2:*
- Oxford comma after "architecture" in the first para.
*Chapter 4:*
- "At the Select Additional Features to Install screen, select the required components: "
This could be "Select the required components from the Select Additional Features to Install screen"?
- "When done, JBoss Developer Studio Integration Stack and the integration stack components are ready to use. "
When complete? Once installed?
- In Warning "The IDE changes do not take effect until the IDE is restarted and the IDE may be unstable until it is restarted. "
Kind of awkward as IDE is repeated x3 and restarted is there twice. Maybe:
The IDE changes are not applied until it is restarted. The IDE may be unstable until it is restarted and the changes take effect.
*Chapter 6*
- The sub-steps here could use a full stop based on the IBM style guide pp84-85.
- Same Warning as in previous chapter
*Chapter 7*
- Same point about the sub-steps and full stops. Some have them here, some don't.
- Before the last Important is missing a full stop. "For plug-in specific configuration information, see the appropriate Red Hat JBoss product documentation available from the Red Hat Customer Portal"
*Chapter 8*
- Several steps throughout the procedure are missing full stops at the end.
- Step 2 "optional" should probably be capitalized. I'm not 100% sure of this, but it seems awkward being lower case at the beginning of a step.
- Same as above with Step 6, which is also missing the opening bracket.
- Same Warning as in Chapters 5 and 6.
--
This message was sent by Atlassian JIRA
(v7.2.3#72005)
More information about the jbosstools-issues
mailing list