Bug 779635 (SOA-2005)

Summary: QE Review - JBoss Rules Guide
Product: [JBoss] JBoss Enterprise SOA Platform 4 Reporter: David Le Sage <dlesage>
Component: DocumentationAssignee: Len DiMaggio <ldimaggi>
Status: CLOSED NEXTRELEASE QA Contact:
Severity: high Docs Contact:
Priority: high    
Version: 4.3 CP04 ER1   
Target Milestone: ---   
Target Release: 4.3 CP04 CR1   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/SOA-2005
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2010-04-08 02:14:12 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:

Description David Le Sage 2010-03-22 00:32:53 UTC 
Affects: Documentation (Ref Guide, User Guide, etc.)
Date of First Response: 2010-04-07 13:57:39
project_key: SOA

QE Review - as per our discussion on IRC.  Note that this doc has not been changed in this cycle.
Comment 1 Len DiMaggio 2010-04-07 17:57:39 UTC 
Reviewing the document here:
   http://downtown.englab.bne.redhat.com/drafts/JBoss_Enterprise_SOA_Platform/4.3.CP03/JBoss_Rules_Reference_Manual/
Comment 2 Len DiMaggio 2010-04-07 19:01:28 UTC 
Initial comments - the book should be unchanged - but some links are broken and some notes are confusing.

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

All references to:
   http://anonsvn.labs.jboss.com/labs/jbossrules/trunk/

Should be replaced with:
   http://anonsvn.jboss.org/repos/labs/labs/jbossrules/trunk/

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

1.2.3. Drools Update Tool

I cannot find this tool on-line - this link is definitely no longer active: 
   http://anonsvn.labs.jboss.com/labs/jbossrules/trunk/experimental/drools-update/

Looking to see if Edson knows where to find it.

Ah - it's here:
   https://svn.jboss.org/repos/labs/labs/jbossrules/branches/4.0.x/experimental/drools-update/

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

2.4. Rete Algorithm

This link is also broken - server error - 
http://citeseer.ist.psu.edu/context/505087/0

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

5.1. Overview
Note
(updated to Drools 4.0)

5.2. Comments
Note
(updated to Drools 4.0)

5.3. Package
Note
(updated to Drools 4.0)

5.4. Function
Note
(updated to Drools 4.0)

Did we intend to describe these note as "updated to Drools 4.0?"

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

Section: 7.3. References

This reference should be removed - the link is no longer active:

The Java Rule Engine API documentation
http://www.javarules.org/api_doc/api/index.html

========================================
Comment 3 Len DiMaggio 2010-04-07 19:06:30 UTC 
The upgrade tool is actually here:

   http://anonsvn.jboss.org/repos/labs/labs/jbossrules/tags/4.0.7.19894.GA/experimental/drools-update/
Comment 4 Len DiMaggio 2010-04-07 19:37:38 UTC 
Looks like 3 broken links:

[jboss@dhcp-100-18-211 Desktop]$ lynx -crawl -traversal http://downtown.englab.bne.redhat.com/drafts/JBoss_Enterprise_SOA_Platform/4.3.CP03/JBoss_Rules_Reference_Manual/html-single/ > /dev/null

[jboss@dhcp-100-18-211 Desktop]$ cat reject.dat 
http://www.redhat.com/docs
http://www.jboss.com/
http://creativecommons.org/licenses/by-sa/3.0/
https://fedoraproject.org/wiki/Legal:Trademark_guidelines
https://fedorahosted.org/liberation-fonts/
http://bugzilla.redhat.com/bugzilla/
http://anonsvn.labs.jboss.com/labs/jbossrules/trunk/experimental/drools-update/
http://en.wikipedia.org/wiki/Formal_grammar
http://en.wikipedia.org/wiki/Emil_Leon_Post
http://citeseer.ist.psu.edu/context/505087/0
http://jung.sourceforge.net/
http://www.redhat.com/docs/en-US/JBoss_SOA_Platform/
http://fit-for-rules.sourceforge.net/
http://fit-for-rules.sourceforge.net/
http://www.w3.org/TR/2006/WD-rif-ucr-20060323/
http://ruleml.org/
http://www.jcp.org/en/jsr/detail?id=94
http://www.javarules.org/api_doc/api/index.html
http://www.theserverside.com/articles/article.tss?l=Drools
http://java.sun.com/developer/technicalArticles/J2SE/JavaRule.html
http://www.theserverside.com/articles/article.tss?l=Jess

[jboss@dhcp-100-18-211 Desktop]$ for file in $( cat reject.dat ); do echo " "; echo $file; lynx -dump -head $file | grep HTTP | grep -E '404|500'  ; done
 
http://www.redhat.com/docs
 
http://www.jboss.com/
 
http://creativecommons.org/licenses/by-sa/3.0/
 
https://fedoraproject.org/wiki/Legal:Trademark_guidelines
 
https://fedorahosted.org/liberation-fonts/
 
http://bugzilla.redhat.com/bugzilla/
 
http://anonsvn.labs.jboss.com/labs/jbossrules/trunk/experimental/drools-update/
HTTP/1.1 404 Not Found
 
http://en.wikipedia.org/wiki/Formal_grammar
 
http://en.wikipedia.org/wiki/Emil_Leon_Post
 
http://citeseer.ist.psu.edu/context/505087/0
HTTP/1.1 500 Internal Server Error
 
http://jung.sourceforge.net/
 
http://www.redhat.com/docs/en-US/JBoss_SOA_Platform/
 
http://fit-for-rules.sourceforge.net/
 
http://fit-for-rules.sourceforge.net/
 
http://www.w3.org/TR/2006/WD-rif-ucr-20060323/
 
http://ruleml.org/
 
http://www.jcp.org/en/jsr/detail?id=94
 
http://www.javarules.org/api_doc/api/index.html
HTTP/1.1 404 Not Found
 
http://www.theserverside.com/articles/article.tss?l=Drools
 
http://java.sun.com/developer/technicalArticles/J2SE/JavaRule.html
 
http://www.theserverside.com/articles/article.tss?l=Jess
[jboss@dhcp-100-18-211 Desktop]$
Comment 5 David Le Sage 2010-04-08 00:59:37 UTC 
Updated all broken links cited above.
Comment 6 Len DiMaggio 2010-04-08 02:14:12 UTC 
Verified in the doc here:

   http://downtown.englab.bne.redhat.com/drafts/JBoss_Enterprise_SOA_Platform/4.3.CP03/JBoss_Rules_Reference_Manual/html-single/