Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 927314

Summary: Inaccuracies in Getting Started with HTML5 Mobile Web Development
Product: [Retired] JBoss Enterprise WFK Platform 2 Reporter: Tolis Emmanouilidis <aemmanou>
Component: doc-Getting-Started-With-HTML5-Mobile-Web-DevelopmentAssignee: Petr Penicka <ppenicka>
Status: CLOSED CURRENTRELEASE QA Contact: Emil Cervenan <ecervena>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 2.2.0CC: kpiwko, oskutka, ppenicka
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
: 949513 (view as bug list) Environment:
Last Closed: 2013-06-11 15:54:17 UTC 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: 949513    

Description Tolis Emmanouilidis 2013-03-25 15:58:23 UTC
Description of problem:

1.2.1. Using the Command Line
Latest version of Maven archetype is 7.1.3.CR3

Procedure 1.5. QUnit and JBoss Developer Studio
Could not execute the QUnit tests included in index.html since jquery-1.8.1.min.js script does not exist inside the resources folder. However the jquery-1.8.2.min.js exists inside the resources folder so the index.html has to be changed to include the JQuery 1.8.2 version instead of 1.8.1.

Procedure 1.6. JBoss Developer Studio Browser Simulator
The procedure mentioned in the doc opens the file:///home/../../jboss-as-kitchensink-html5-mobile/src/main/webapp/index.html. Obviously the application is not functional on the BrowserSim since the file is opened through the file protocol and moreover the URL does not corresponds to the URL shown in the Figure 1.8. Mobile

It would be better to guide the users to follow the below steps:
1. Window -> Web browser -> BrowserSim
2. index.html -> Run As -> Run on Server 


2.1.6.1. Member.java
The path should be <project-source>src/main/java/org/jboss/tools/example/html5/model

2.1.6.2. MemberService.java
The path should be <project-source>src/main/java/org/jboss/tools/example/html5/rest

2.1.6.3. JSONP Support
The path should be <project-source>src/main/javaorg/jboss/tools/example/html5/util for JSONPRequestFilter.java

The path should be <project-source>src/main/java/org/jboss/tools/example/html5/rest for JaxRsActivator.java

The path should be <project-source>src/main/javaorg/jboss/tools/example/html5/util for Resources.java

Comment 1 Petr Penicka 2013-04-02 16:05:13 UTC
Fixed all issues except the following:

Procedure 1.5. QUnit and JBoss Developer Studio
Could not execute the QUnit tests included in index.html since jquery-1.8.1.min.js script does not exist inside the resources folder. However the jquery-1.8.2.min.js exists inside the resources folder so the index.html has to be changed to include the JQuery 1.8.2 version instead of 1.8.1.

Procedure 1.6. JBoss Developer Studio Browser Simulator
The procedure mentioned in the doc opens the file:///home/../../jboss-as-kitchensink-html5-mobile/src/main/webapp/index.html. Obviously the application is not functional on the BrowserSim since the file is opened through the file protocol and moreover the URL does not corresponds to the URL shown in the Figure 1.8. Mobile

It would be better to guide the users to follow the below steps:
1. Window -> Web browser -> BrowserSim
2. index.html -> Run As -> Run on Server 

These will be fixed later. Nothing is on the stage yet - please do not review the changes.

Comment 2 Tolis Emmanouilidis 2013-04-09 15:20:22 UTC
Just an update:

On 1.2.1 section it states:

--
Maven downloads the archetype and its dependencies and prompts for more information:

GroupID
    the base package for the project 
ArtifactID
    the name of the project 
Version
    the starting version of the project 
Package
    if it is different from the GroupID 

Select the required values and press 'Y' when prompted. 
--

It would be nice to guide the user to fill the below GroupId and ArtifactID so that both Command line and JBDS way will produce the same project (same package etc):

GroupID --> org.jboss.tools.example.html5

ArtifactID --> jboss-as-kitchensink-html5-mobile

Comment 3 Petr Penicka 2013-04-10 17:04:24 UTC
I fixed all the issues mentioned above + 

- replaced mentions of JBDS 5 with JBDS 6
- retook screenshots in JBDS 6
- some minor fixes here and there (language, typos, formatting, markup, ...)

The guide would deserve a bit more care, but no time to do it now. TODO in the next release.

Docs stage URL: https://documentation-devel.engineering.redhat.com/docs/en-US/JBoss_Web_Framework_Kit/2.2/html-single/Getting_Started_with_HTML5_Mobile_Web_Development/index.html

Build: JBoss_Web_Framework_Kit-Getting_Started_with_HTML5_Mobile_Web_Development-2.2-en-US-2.2.0-4

Comment 4 Petr Penicka 2013-04-10 17:08:24 UTC
Oops, staged a wrong version. The correct one is going to be: 

JBoss_Web_Framework_Kit-Getting_Started_with_HTML5_Mobile_Web_Development-2.2-en-US-2.2.0-5

The build can be viewed in page meta tags: right-click -> View Page Info -> Meta -> package

Comment 5 Petr Penicka 2013-04-10 19:15:36 UTC
So finally yet another build:

JBoss_Web_Framework_Kit-Getting_Started_with_HTML5_Mobile_Web_Development-2.2-en-US-2.2.0-6

It's on the docs stage now, ready for QE verification.

Comment 7 Tolis Emmanouilidis 2013-04-11 10:00:24 UTC
The mentioned issues have been fixed. Thnx