Bug 777809 (SOA-335)

Summary:	Multiple copies of docs
Product:	[JBoss] JBoss Enterprise SOA Platform 4	Reporter:	ryan.campbell <rcampbell>
Component:	Documentation, Build Process	Assignee:	trev <tkirby>
Status:	CLOSED NEXTRELEASE	QA Contact:
Severity:	urgent	Docs Contact:
Priority:	urgent
Version:	4.2 Beta 2
Target Milestone:	---
Target Release:	4.2 CR1
Hardware:	Unspecified
OS:	Unspecified
URL:	http://jira.jboss.org/jira/browse/SOA-335
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2008-02-04 20:19:13 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:

Description ryan.campbell 2008-01-17 00:46:20 UTC

Date of First Response: 2008-01-17 10:33:33
project_key: SOA

I noticed that the release size ballooned between beta1 & beta2.  Looking at it with a disk usage analyzer, I discovered the following:

EAP docs are present three times:

jboss-as/docs/eap/jboss-eap-4.3/doc/
jboss-as/docs/esb/eap/jboss-eap-4.3/doc/
jboss-as/docs/esb/esb/eap/jboss-eap-4.3/doc/

ESB docs are present twice:

jboss-as/docs/esb/
jboss-as/docs/esb/esb

Comment 1 ryan.campbell 2008-01-17 00:54:08 UTC

actually ESB docs are present three times as well:

[rcampbell@rcampbell docs]$ find -name esb
./esb
./esb/esb
./esb/esb/esb

Comment 2 Len DiMaggio 2008-01-17 15:33:33 UTC

After a telephone conversation with Trevor, we have this porposed solution:

-------------------------------------------------------------

For the standalone server - no changes:

[ldimaggi@ldimaggi docs]$ pwd
/opt/Beta2/jboss-soa-p-standalone.4.2.0/docs

[ldimaggi@ldimaggi docs]$ ls -1
Adapters.pdf
advanced
dtd
examples
FAQ.txt
GettingStarted.pdf
governance
JBoss_Rules_Manual
JBoss_Rules_Manual.pdf
JBPM_Users_Guide
JBPM_Users_Guide.pdf
licenses
README_FIRST.txt
ReleaseNotes.pdf
samples
schema
services
SOA_ESB_Administrators_Guide
SOA_ESB_Administrators_Guide.pdf
SOA_ESB_Message_Action_Guide
SOA_ESB_Message_Action_Guide.pdf
SOA_ESB_Programmers_Guide
SOA_ESB_Programmers_Guide.pdf
tools
wiki

-------------------------------------------------------------

For the embedded server:


[ldimaggi@ldimaggi jboss-as]$ pwd
/opt/Beta2/jboss-soa-p.4.2.0/jboss-as

ls docs
eap (this dir will contain all the eap docs)
esb (this will contain all the ESB docs - the same list shown above for the standalone server)

Comment 3 Len DiMaggio 2008-01-21 15:08:13 UTC

Link: Added: This issue related SOA-260

Comment 4 Len DiMaggio 2008-02-04 20:19:02 UTC

In CR2 build seeing:

Embedded server: 

[ldimaggi@ldimaggi jboss-soa-p.4.2.0]$ pwd
/opt/RC2/jboss-soa-p.4.2.0
[ldimaggi@ldimaggi jboss-soa-p.4.2.0]$ ll
total 72
drwxr-xr-x  4 ldimaggi ldimaggi  4096 Feb  3 16:26 docs
drwxr-xr-x  9 ldimaggi ldimaggi  4096 Feb  3 16:26 jboss-as
drwxr-xr-x  9 ldimaggi ldimaggi  4096 Feb  3 16:27 jbpm-jpdl
drwxr-xr-x 10 ldimaggi ldimaggi  4096 Feb  3 16:21 seam
-rw-r--r--  1 ldimaggi ldimaggi 18882 Feb  2 21:15 SOA_Release_Notes.htm
-rw-r--r--  1 ldimaggi ldimaggi 11513 Feb  2 21:15 SOA_Release_Notes.txt
[ldimaggi@ldimaggi jboss-soa-p.4.2.0]$ tree -L 2 docs
docs
|-- SOA_Getting_Started_Guide.pdf
|-- eap
|   |-- dtd
|   |-- examples
|   |-- jboss-eap-4.3
|   |-- licenses
|   `-- schema
`-- esb
    |-- Adapters.pdf
    |-- GettingStarted.pdf
    |-- JBPM_Users_Guide.pdf
    |-- JBoss_Rules_Manual.pdf
    |-- SOA_ESB_Administrators_Guide.pdf
    |-- SOA_ESB_Message_Action_Guide.pdf
    |-- SOA_ESB_Programmers_Guide.pdf
    |-- advanced
    |-- dtd
    |-- examples
    |-- governance
    |-- licenses
    |-- samples
    |-- schema
    |-- services
    |-- tools
    `-- wiki

17 directories, 8 files

==============================

In the standalone server:

[ldimaggi@ldimaggi jboss-soa-p-standalone.4.2.0]$ pwd
/opt/RC2/jboss-soa-p-standalone.4.2.0
[ldimaggi@ldimaggi jboss-soa-p-standalone.4.2.0]$ ll
total 64
drwxr-xr-x 12 ldimaggi ldimaggi  4096 Feb  3 16:25 docs
drwxr-xr-x  9 ldimaggi ldimaggi  4096 Feb  3 16:25 jboss-as
drwxr-xr-x  9 ldimaggi ldimaggi  4096 Feb  3 16:25 jbpm-jpdl
-rw-r--r--  1 ldimaggi ldimaggi 18882 Feb  2 21:15 SOA_Release_Notes.htm
-rw-r--r--  1 ldimaggi ldimaggi 11513 Feb  2 21:15 SOA_Release_Notes.txt
[ldimaggi@ldimaggi jboss-soa-p-standalone.4.2.0]$ tree -L 1 docs
docs
|-- Adapters.pdf
|-- GettingStarted.pdf
|-- JBPM_Users_Guide.pdf
|-- JBoss_Rules_Manual.pdf
|-- SOA_ESB_Administrators_Guide.pdf
|-- SOA_ESB_Message_Action_Guide.pdf
|-- SOA_ESB_Programmers_Guide.pdf
|-- SOA_Getting_Started_Guide.pdf
|-- advanced
|-- dtd
|-- examples
|-- governance
|-- licenses
|-- samples
|-- schema
|-- services
|-- tools
`-- wiki

10 directories, 8 files

Comment 5 Len DiMaggio 2008-02-04 20:19:13 UTC

Verified fixed in CR2