[
https://issues.jboss.org/browse/JBDS-2818?page=com.atlassian.jira.plugin....
]
Nick Boldt commented on JBDS-2818:
----------------------------------
Confused by some of your suggested changes.
On line
https://github.com/jbdevstudio/jbdevstudio-website/pull/45/files#diff-5c4...
you changed "JBDS" to "JBoss Developer Studio" per the branding
guidelines for the abbreviated name usage. This is good.
But on line
https://github.com/jbdevstudio/jbdevstudio-website/pull/45/files#diff-3f4...
you changed "installer" to "JBDS universal installer", which reverts
to using the no-longer acceptable "JBDS" abbreviation, and adds
"universal" which is not needed any more than "for your platform" is.
You also change "Double-click the installer file to run it, or open a terminal and
type" to "To start the installer, double-click the installer file or in a CLI
enter" ... surely "open a terminal" is more Windows user friendly than
"in a CLI" ? Would "To start the installer, double-click the installer file
or open a *console* and in it type ... " be better?
I also see that you've added more occurrences of "Red Hat JBoss Developer
Studio" so that there are more than 1 per page, eg., on
https://github.com/jbdevstudio/jbdevstudio-website/pull/45/files#diff-035...
- I thought we only needed the full name for the first occurrence on the page, and could
use the simplified/abbreviated "JBoss Developer Studio" for subsequent
instances?
Text in Early Access and Update page needs minor editing
--------------------------------------------------------
Key: JBDS-2818
URL:
https://issues.jboss.org/browse/JBDS-2818
Project: Developer Studio (JBoss Developer Studio)
Issue Type: Bug
Security Level: Public(Everyone can see)
Components: documentation
Affects Versions: 7.0.1.GA
Reporter: Michelle Murray
Assignee: Nick Boldt
Fix For: 7.1.0.Beta1
Both of these templates need the text modifying (to fit Red Hat writing style and 508
compliance):
https://devstudio.jboss.com/updates/7.0/
https://devstudio.jboss.com/earlyaccess/7.0.0.GA.html
*Common text modifications:*
* Section "Installation :: Core Tooling"
{quote}
1. If not already installed, download and install Oracle JDK or OpenJDK 7 (or 6).
2. Download the JBDS universal installer from <link>.
3. To start the installer, double-click the installer file or in a CLI enter java -jar
jbdevstudio-*.jar
{quote}
* Section "Looking for JBoss EAP ..."
Logo has changed, now just logotype. Looking for link.
* Section "Getting Started Guide:"
{quote}
Adding *JBoss* EAP to JBDS
{quote}
*Early Access text modifications:*
* Title should be "*Red Hat* JBoss Developer Studio ......"
* Intro text
{quote}
We wish to give customers and users early access to *JBoss Developer Studio* so *that* we
can make the next version of JBoss Developer Studio an even better environment for
developing with and for Red Hat JBoss Middleware.
{quote}
*Updates text modifications*
* Why do we have this text? I ask because, for example, in
https://devstudio.jboss.com/updates/7.0/, on the right-hand side the "installer"
link in installation step 2 takes you to
https://devstudio.jboss.com/earlyaccess/7.0.0.GA.html where you can download what looks
like the GA version without subscription or opting in to a trial. Also you can get JBDS
BYOE without subscription or trial on Eclipse marketplace. Seems the text is outdated but
I don't know all the ins and outs of JBDS marketing and alike - hence asking the
question.
{quote}
If you do not already have a copy of JBoss Developer Studio, you can purchase a
subscription or get a
30-day Free Trial from here:
https://access.redhat.com/downloads/.
{quote}
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see:
http://www.atlassian.com/software/jira