Bug 780015 (SOA-2376) - QE Review - Data Services Developer Guide
Summary: QE Review - Data Services Developer Guide
Keywords:
Status: CLOSED NEXTRELEASE
Alias: SOA-2376
Product: JBoss Enterprise SOA Platform 5
Classification: JBoss
Component: Documentation
Version: unspecified
Hardware: Unspecified
OS: Unspecified
urgent
urgent
Target Milestone: ---
: 5.1.0 GA
Assignee: Len DiMaggio
QA Contact:
URL: http://jira.jboss.org/jira/browse/SOA...
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2010-10-05 00:28 UTC by Dana Mison
Modified: 2011-03-03 17:31 UTC (History)
1 user (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2011-03-03 17:31:23 UTC
Type: Task


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Issue Tracker SOA-2376 0 None None None Never

Description Dana Mison 2010-10-05 00:28:49 UTC
Affects: Documentation (Ref Guide, User Guide, etc.)
project_key: SOA

Data Services Developer Guide draft document is ready for first pass QE review.

Available at: http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Enterprise_SOA_Platform/5/html/Data_Services_Developer_Guide/index.html

Review Comments go here: https://docspace.corp.redhat.com/docs/DOC-49211

Comment 1 Len DiMaggio 2010-10-07 16:48:25 UTC
Added comments to:  https://docspace.corp.redhat.com/docs/DOC-49211

Comment 2 Len DiMaggio 2010-10-07 16:51:05 UTC
Assigning back to Darrin after 1st round of QE reviews

Comment 3 Anne-Louise Tangring 2010-12-06 16:46:01 UTC
This task has to be completed before GA. Marking as blocker for easier tracking.

Comment 4 Dana Mison 2010-12-17 01:00:00 UTC
Labels: Removed: qe-docsreview Added: DS_Developer_Guide qe-docsreview


Comment 6 Dana Mison 2011-01-05 00:12:19 UTC
Writer: Added: Darrin


Comment 7 Dana Mison 2011-01-31 05:05:35 UTC
doc updated & pushed to stage

outstanding items emailed for feedback:


Section 1.1
Can be a JCA Connector or any other custom connection provider. Teiid recommends and uses JCA as its specification defines how you can write, package, and configure access to EIS system in consistent manner.

Open issue – We recommend that customers use the vendor-supplied JCA adapters for using JMS with JCA. Will we do the same for using Teiid with JCA?

Section 1.2.1, 1.3.1
For sample Translator code, refer to the Teiid source code athttp://anonsvn.jboss.org/repos/teiid/trunk/connectors/

Where will the Teiid source be available from ? Will it be a standalone ZIP or included with the SOA source? And (assuming it will be available for download as a ZIP) what directory of the repo will be the root of the ZIP ?  eg, if the docs refer to http://anonsvn.jboss.org/repos/teiid/trunk/connectors/ how will that be available in the ZIP - noting that the product docs will really be referring to the branch source although the upstream docs generally refer to the trunk.

Section 3.1.7. Metadata
Override and implement the method getMetadata(), if you want to expose the metadata about the source for use in Dynamic VDBs. This defines the tables, column names, procedures, parameters, etc. for use in the query engine. This method is not yet used by Designer tooling.

Open issue: Need to check with the Dev team about “This method is not yet used by Designer tooling.” What are the user impacts of this?


Comment 9 Len DiMaggio 2011-02-14 19:14:57 UTC
The last edit that I was looking for was to list the source directories in the source.zip - once this is resolved the JIRA can be resolved.

Comment 10 Dana Mison 2011-03-03 05:48:19 UTC
update doc and restaged.  Last updated items on the docspace page have DONE in bold to identify them.

Comment 11 Dana Mison 2011-03-03 05:48:19 UTC
Release Notes Docs Status: Added: Not Required


Comment 12 Len DiMaggio 2011-03-03 17:31:23 UTC
Verified in the doc.


Note You need to log in before you can comment on or make changes to this bug.