Bug 813333

Summary: Installation guide comments
Product: [JBoss] JBoss Enterprise Portal Platform 5 Reporter: Michal Vanco <mvanco>
Component: DocumentationAssignee: JPP Docs Team <jpp-docs>
Status: MODIFIED --- QA Contact: Martin Vecera <mvecera>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 5.2.1.GACC: epp-bugs, mvecera
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
: 813776 (view as bug list) Environment:
Last Closed: Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 813776    

Description Michal Vanco 2012-04-17 14:11:54 UTC
Comments for installation guide will follow (version is 5.2.1 CR02 at the time of creation)

Comment 1 Michal Vanco 2012-04-17 14:12:24 UTC
main page:
for use with JBoss Enterprise Portal Platform and Site Publisher 5.2.0
->
for use with JBoss Enterprise Portal Platform and Site Publisher 5.2.1

2.1.
5.2.0 -> 5.2.1

Chapter 3. ZIP Installation from the Red Hat Customer Portal
Complete this task to download the Zip archives from the Red Hat Customer Portal used to install the platform, and Site Publisher .
->
Complete this task to download the Zip archives from the Red Hat Customer Portal used to install the platform, and Site Publisher.

step 8.b.
Click the Download link to start the Portal download. 
->
Click the Download link to start the Site Publisher add-on download. 

task:install the plaform
Complete this task to install the platform a Zip archive.
->
Complete this task to install the platform from a Zip archive.

6.5. Disable Pre-configured Accounts
3. Result
The login links on the front page of the portal main screen will not display, and the accounts are not available for use. 
- this is not correct, links on main page are displayed but clicking on them returns 403, and it's still possible to use accounts (root,john,mary,demo) at common sign in dialog

Chapter 7.  Test your Installation
Clustered Windows
> run.sh -c production -Dexo.profiles=cluster
->
> run.bat -c production -Dexo.profiles=cluster

Standard Portal, with HTTPS configured, and Site Publisher.
    Open http://localhost:8443/ecmdemo/public/classic 
->
    Open http://localhost:8443/ecmdemo/

Comment 2 Jared MORGAN 2012-10-10 23:56:43 UTC
TRIAGE INFORMATION

Relevance: EPP 5.2 and EPP 6

==Task==

Make the changes as prescribed in both versions. 

==Requirements== 

Ensure you have access to:

http://svn.jboss.org/repos/gatein/epp/docs/branches/5.2/ and http://svn.jboss.org/repos/gatein/epp/docs/branches/6.0/

to make changes to these guides.

==Resolving==

Add Revision History to each guide, and stage the books. 

Commit changes to SVN trunks.

Update the BZ with tracking info.

Comment 3 Scott Mumford 2012-10-11 03:10:40 UTC
The issues above that had not already been corrected have been fixed and the changes committed to the repo.
Committed revision 8867.

Comment 6 Leslie Satenstein 2013-08-02 02:03:12 UTC
Improvement recommendation for Install Guide.

http://docs.fedoraproject.org/en-US/Fedora/19/html/Installation_Guide/Installation-Guide-Preface.html#idp16047392

Under 
1.1. Typographic Conventions

The indented paragraph reads
 To see the contents of the file my_next_bestselling_novel in your current working directory, enter the cat my_next_bestselling_novel command at the shell prompt and press Enter to execute the command. 

I would replace the word "see" with view. 

    To view the contents of the...

See for me, would be the result of issuing the ls command. See the file, view the contents.

As an aside, for French translation,  "to see" translates to "regarder"  whereas view tranlates to "voir". 

Please correct for Fedora 20.
======
Further on the same page...

Warnings should not be ignored. Ignoring warnings will most likely cause data loss. 

My comment.

Warnings do not cause data loss. Warnings advise of a situation that if not attended to, will most likely cause data loss. 

=======
Follow page with Introduction
Introduction
This guide covers installation of Fedora, a Linux distribution built on free and open source software.

Please change ... built on ...  to built with. 

My reasoning... You may be on topic, or build on a foundation, but Fedora is built with free and open source software

=======
Another question.  Would you say, "Install Fedora on a computer," or would you say "Install Fedora onto a computer"?  If the latter is more correct, this fragment is found within the Audience section. 

=======

2.1.1. How Do I Download Installation Files?
To follow a Web-based guide to downloading, visit http://get.fedoraproject.org/. For guidance on which architecture to download, refer to Section 2.1.2, “Which Architecture Is My Computer?”. 

Would the meaning be more clear if the title started with the word "Of" as in 
"Of which Architecture Is My Computer?"
(sections 2.1.2 and 2.1.3)

I will continue reading and commenting beginning Chapter 3 in a later posting. Please contact me under separate email if you wish me to continue to nit-pick.

Comment 7 Jared MORGAN 2013-08-04 23:58:40 UTC
(In reply to Leslie Satenstein from comment #6)
> Improvement recommendation for Install Guide.
> 
> http://docs.fedoraproject.org/en-US/Fedora/19/html/Installation_Guide/
> Installation-Guide-Preface.html#idp16047392
> 
> Under 
> 1.1. Typographic Conventions
> 
> The indented paragraph reads
>  To see the contents of the file my_next_bestselling_novel in your current
> working directory, enter the cat my_next_bestselling_novel command at the
> shell prompt and press Enter to execute the command. 
> 
> I would replace the word "see" with view. 
> 
>     To view the contents of the...
> 
> See for me, would be the result of issuing the ls command. See the file,
> view the contents.
> 
> As an aside, for French translation,  "to see" translates to "regarder" 
> whereas view tranlates to "voir". 
> 
> Please correct for Fedora 20.
> ======
> Further on the same page...
> 
> Warnings should not be ignored. Ignoring warnings will most likely cause
> data loss. 
> 
> My comment.
> 
> Warnings do not cause data loss. Warnings advise of a situation that if not
> attended to, will most likely cause data loss. 
> 
> =======
> Follow page with Introduction
> Introduction
> This guide covers installation of Fedora, a Linux distribution built on free
> and open source software.
> 
> Please change ... built on ...  to built with. 
> 
> My reasoning... You may be on topic, or build on a foundation, but Fedora is
> built with free and open source software
> 
> =======
> Another question.  Would you say, "Install Fedora on a computer," or would
> you say "Install Fedora onto a computer"?  If the latter is more correct,
> this fragment is found within the Audience section. 
> 
> =======
> 
> 2.1.1. How Do I Download Installation Files?
> To follow a Web-based guide to downloading, visit
> http://get.fedoraproject.org/. For guidance on which architecture to
> download, refer to Section 2.1.2, “Which Architecture Is My Computer?”. 
> 
> Would the meaning be more clear if the title started with the word "Of" as
> in 
> "Of which Architecture Is My Computer?"
> (sections 2.1.2 and 2.1.3)
> 
> I will continue reading and commenting beginning Chapter 3 in a later
> posting. Please contact me under separate email if you wish me to continue
> to nit-pick.

I think you have reported this issue under the wrong bug, Leslie. This is a ticket for the Installation Guide for Red Hat JBoss Portal Platform.