[jbosstools-issues] [JBoss JIRA] (JBDS-2818) Text in Early Access and Update page needs minor editing

[Nick Boldt (JIRA)]

    [ https://issues.jboss.org/browse/JBDS-2818?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12850573#comment-12850573 ] 

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-5c46e3ccca1b59d74ab63b9b022d1b15L45 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-3f433e8b7b34c0ba4cf912d687b1509fL76 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-03511f18087a75d59888891cca9fc6e6R150 - 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