[JBoss JIRA] (JBDS-4220) Installation Guide peer review
by Gemma Sheldon (JIRA)
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)
9 years, 3 months
[JBoss JIRA] (JBDS-4220) Integration Stack Installation Guide peer review
by Gemma Sheldon (JIRA)
[ https://issues.jboss.org/browse/JBDS-4220?page=com.atlassian.jira.plugin.... ]
Gemma Sheldon updated JBDS-4220:
--------------------------------
Summary: Integration Stack Installation Guide peer review (was: Installation Guide peer review)
> Integration Stack 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)
9 years, 3 months
[JBoss JIRA] (JBDS-4219) minor text fix: bundled installer should say "Install" instead of "Download and Install"
by Misha Ali (JIRA)
Misha Ali created JBDS-4219:
-------------------------------
Summary: minor text fix: bundled installer should say "Install" instead of "Download and Install"
Key: JBDS-4219
URL: https://issues.jboss.org/browse/JBDS-4219
Project: Red Hat JBoss Developer Studio (devstudio)
Issue Type: Bug
Components: platform-installer
Reporter: Misha Ali
Priority: Minor
The bundled and online installer both have a button when selecting components that says "Download & Install" and the next screen shows the current step in the process at the top of the installer screen as "Download & Install" as well. This is correct for the online installer but not for the bundled installer and should be changed to something like just "Install".
--
This message was sent by Atlassian JIRA
(v7.2.3#72005)
9 years, 3 months
[JBoss JIRA] (JBDS-4218) link in installer finish screen points to redundant instructions instead of cdk how to
by Misha Ali (JIRA)
[ https://issues.jboss.org/browse/JBDS-4218?page=com.atlassian.jira.plugin.... ]
Misha Ali commented on JBDS-4218:
---------------------------------
Checked again and took a screenshot of the page it takes me to from the mac installer at the moment (attached). It doesn't redirect anywhere after this page that I can tell, so this may be something to fix up as soon as we can.
> link in installer finish screen points to redundant instructions instead of cdk how to
> --------------------------------------------------------------------------------------
>
> Key: JBDS-4218
> URL: https://issues.jboss.org/browse/JBDS-4218
> Project: Red Hat JBoss Developer Studio (devstudio)
> Issue Type: Bug
> Components: platform-installer
> Environment: Mac OS X Sierra (10.2) Mac mini
> Reporter: Misha Ali
> Assignee: Denis Golovin
> Attachments: Screen Shot 2016-12-12 at 1.11.33 PM.png
>
>
> Testing the Mac installer (online variant) and the finish screen that tells you to either open devstudio or see information about how to start using CDK points to this:
> https://developers.redhat.com/products/devsuite/get-started/
> This page has instructions to install devsuite, which is redundant because the finish screen indicates you already just did this. Not sure what this should point to, but it seems like this is probably not the correct page.
--
This message was sent by Atlassian JIRA
(v7.2.3#72005)
9 years, 3 months