Bug 779266 (SOA-1657)

Summary: jUDDI v3 user guide
Product: [JBoss] JBoss Enterprise SOA Platform 5 Reporter: Len DiMaggio <ldimaggi>
Component: DocumentationAssignee: Default User <jbpapp-maint>
Status: CLOSED NEXTRELEASE QA Contact:
Severity: high Docs Contact:
Priority: high    
Version: unspecifiedCC: atangrin, soa-p-jira
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/SOA-1657
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
: 779267 779268 (view as bug list) Environment:
Last Closed: 2011-11-30 16:36:36 UTC Type: Task
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Bug Depends On: 779495    
Bug Blocks: 779127, 779265, 779457    
Attachments:
Description Flags
juddi_console_chapter.odt none

Description Len DiMaggio 2009-11-30 19:48:25 UTC
Affects: Documentation (Ref Guide, User Guide, etc.)
Date of First Response: 2009-12-01 16:06:48
project_key: SOA

The book is here:
   http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Enterprise_SOA_Platform/5.0.0/html/jUDDI_User_Guide/

Comment 3 Dana Mison 2009-12-02 09:49:16 UTC
Off the top of my head, candidates for removal:

Chapter 2 - it's only download/install instructions
Chapter 4 - database config directions, this is handled within SOA already
Chapter 6 - is minimal, does it apply to SOA anyway?
Chapter 8 - is just placeholder content, unless content is supplied from jUDDI project

Also are the screenshots correct for what will be shipping in SOA ?

Comment 4 Len DiMaggio 2009-12-02 20:08:49 UTC
My vote:

Chapter 2 - it's only download/install instructions
      Yes, remove it

Chapter 4 - database config directions, this is handled within SOA already
      Yes, remove it

Chapter 6 - is minimal, does it apply to SOA anyway?
      I think that this should stay

Chapter 8 - is just placeholder content, unless content is supplied from jUDDI project 
      Kurt did write up something on annotations here:  http://apachejuddi.blogspot.com/2009/11/uddi-annotations-how-do-i-self-register.html
      Haven't seen anything in the project docs yet. 

Comment 6 Len DiMaggio 2009-12-04 21:23:34 UTC
Section 1.1 "Introduction" and Section 1.2 "UDDI Registry" are copies of 
sections 1.1.1.1 "Introduction" through 1.1.1.6 "The Registry and the JBoss Service-Oriented Architecture Platform" in the Services Guide.

But...

The information is more detailed and presented better in the services guide.

****** Given the amount of overlap and and of jUDDI-project specific material that we are already removing from the SOA-P jUDDI guide, maybe it's time that we drop the standalone SOA-P jUDDI guide and just expand the services guide?



Comment 8 Len DiMaggio 2009-12-07 17:11:13 UTC
Link: Added: This issue is related to SOA-1625


Comment 9 Len DiMaggio 2009-12-07 17:11:14 UTC
Link: Added: This issue is related to SOA-1632


Comment 10 Dana Mison 2009-12-08 04:40:41 UTC
Comment for reference: jUDDI & Services Guide need to be kept separate.

Comment 11 Dana Mison 2009-12-08 04:45:16 UTC
Can someone clarify instances in the jUDDI guide where URLs should be updated as per SOA-1625

NOTE: document abstract should also note that content is specific to SOA 5.0

Comment 13 Len DiMaggio 2009-12-08 19:56:13 UTC
Darrin - can you create a new draft of this doc? Some of the changes needed are pretty dramatic - can we review this again before beta?

Comment 14 Dana Mison 2009-12-17 08:14:41 UTC
5.0.0 Beta1 doc is available on http://redhat.com/docs/JBoss_SOA_Platform/

Comment 15 Len DiMaggio 2010-01-19 00:02:21 UTC
Link: Added: This issue is a dependency of SOA-1842


Comment 16 Len DiMaggio 2010-01-19 00:45:29 UTC
Re-assigning back to Len (QE) for 2nd pass review. 

Comment 17 Len DiMaggio 2010-01-22 01:27:58 UTC
Link: Added: This issue is related to SOA-1663


Comment 18 Len DiMaggio 2010-01-22 01:38:40 UTC
Link: Added: This issue is related to SOA-1826


Comment 19 Len DiMaggio 2010-01-22 01:38:40 UTC
Link: Added: This issue is related to SOA-1710


Comment 20 Len DiMaggio 2010-01-22 01:38:40 UTC
Link: Added: This issue is related to SOA-1693


Comment 23 Len DiMaggio 2010-01-25 17:04:28 UTC
Link: Added: This issue depends SOA-1879


Comment 25 Len DiMaggio 2010-01-27 21:24:07 UTC
Attachment: Added: juddi_console_chapter.odt


Comment 27 Len DiMaggio 2010-01-28 20:44:04 UTC
Link: Added: This issue is a dependency of SOA-1656


Comment 28 Dana Mison 2010-02-02 06:01:00 UTC
doc is going to ship post GA

Comment 29 Dana Mison 2010-02-02 06:01:00 UTC
Affects: Added: [Documentation (Ref Guide, User Guide, etc.)]


Comment 31 Dana Mison 2010-02-04 01:13:00 UTC
No doc will ship for GA

Comment 32 Len DiMaggio 2010-02-08 19:53:17 UTC
Link: Added: This issue is a dependency of SOA-1525


Comment 34 David Le Sage 2011-07-14 04:50:02 UTC
Release Notes Docs Status: Added: Not Required
Writer: Added: dlesage


Comment 35 David Le Sage 2011-07-14 04:51:09 UTC
I have now created the JUDDI Registry Guide, based on the upstream 3.1 branch.  Any further discussion/issues around it should be added to the QE JIRA.

Comment 36 Len DiMaggio 2011-11-30 16:36:36 UTC
Closing as the book was created for the 5.2.0 release