[rules-dev] Drools 5.1 Released - Javadoc broken, badly

[Wolfgang Laun]

Downloaded Drools Javadocs from http://www.jboss.org/drools/downloads.html.

BAD: The javadoc for drools-server, starting at
javadoc/unstable/drools-server/index.html, is completely broken.

BAD: javadoc/unstable/drools-dataloaders-jaxb/index.html and
javadoc/unstable/drools-dataloaders-smooks/index.html (on
javadoc/index.html) are completely missing; I think that the entries should
be removed from javadoc/index.html.

A minor glitch: All the HTML pages linked from  javadoc/index.html, when
displayed in a browser, end with a single line containing "true".

A minor nuisance: javadoc/index.html still contains "5.0.0".

BAD: The following links from the *stable *Javadoc result in "404 page not
found":

./drools-api/org/drools/runtime/StatelessKnowledgeSession.html:<A HREF="
http://www.jboss.com/products/rules/drools-core/apidocs/org/drools/runtime.command.CommandFactory.html"
title="class or interface in
org.drools"><CODE>runtime.command.CommandFactory</CODE></A>,
./drools-api/org/drools/runtime/StatelessKnowledgeSession.html:<A HREF="
http://www.jboss.com/products/rules/drools-core/apidocs/org/drools/runtime.command.BatchExecution.html"
title="class or interface in
org.drools"><CODE>runtime.command.BatchExecution</CODE></A>,
./drools-api/org/drools/runtime/StatelessKnowledgeSession.html:<A HREF="
http://www.jboss.com/products/rules/drools-core/apidocs/org/drools/runtime.ExecutionResults.BatchExecutionResults.html"
title="class or interface in
org.drools"><CODE>runtime.ExecutionResults.BatchExecutionResults</CODE></A>,

./drools-api/org/drools/runtime/StatelessKnowledgeSession.html:<A HREF="
http://www.jboss.com/products/rules/drools-core/apidocs/org/drools/runtime.help.BatchExecutionHelp.html"
title="class or interface in
org.drools"><CODE>runtime.help.BatchExecutionHelp</CODE></A>,
./drools-api/org/drools/runtime/StatelessKnowledgeSession.html:<A HREF="
http://www.jboss.com/products/rules/drools-pipeline/apidocs/org/drools/runtime/pipeline/PipelineFactory.html"
title="class or interface in
org.drools.runtime.pipeline"><CODE>PipelineFactory</CODE></A>,

BAD: There are so many (similar) broken links (I counted 5147 in 721
different HTML files) in the unstable part that I cannot repeat them here.
Try this:

$ cd javadoc/unstable
$ grep -i 'HREF=' $h | grep -v -i -e 'HREF="\.' -e 'http://java.sun.com' |
grep http

-W


On 3 September 2010 19:37, Mark Proctor <mproctor at codehaus.org> wrote:

>  http://www.theserverside.com/news/thread.tss?thread_id=60824
>
>  Drools 5.1<http://downloads.jboss.com/drools/docs/5.1.1.34858.FINAL/drools-introduction/html_single/index.html#d0e47>has been released. The main focus for this release has been around improved
> consumerability for users with declarative services based on Spring, Camel
> and CXF integration as well as the BPMN2 implementation for Flow and an
> improved Rete algorithm for reduced memory consumption providing better
> scalability for large number of objects.
>
> You can get full release details here:
> Drools 5.1 New and Noteworthy<http://downloads.jboss.com/drools/docs/5.1.1.34858.FINAL/drools-introduction/html_single/index.html#d0e47>
> Download <http://www.jboss.org/drools/downloads.html>
> Documentation <http://jboss.org/drools/documentation.html>
> Drools Blog <http://blog.athico.com>
> Oryx integration for web based BPMN2 Authoring<http://blog.athico.com/2010/09/bpmn2-authoring-in-drools-guvnor.html>
>
>
> Core
> JMX Monitoring
> Spring, Camel and CXF integration
> Knowledge Agent Incremental Change Set Support
>
> Expert
> Differential Update (reduced memory consumption for better scalability)
> Channels
> Live Querries
> Timers and Calendars
>
> Flow
> BPMN2 (Eclipse + Web authoring)
> Pluggable Variable Persistence
>
> Guvnor
> Discussions
> Inbox (to monitor changes)
> Bulk Importer
> Built in Selector
> Working Sets
> Fact Constraints
> Guided editor improvements
> Rule Templates
> Oryx integration for web based BPMN2 editing (more details here<http://blog.athico.com/2010/09/bpmn2-authoring-in-drools-guvnor.html>
> )
>
> Rules Fest <http://rulesfest.org/html/home.html>
> Don't forget about the San Jose Rules Fest Oct 2010<http://rulesfest.org/html/home.html>.
> It's a 3 day event of talks followed by a one day Boot Camp with separate
> rooms for Jess, Drools&jBPM, Grind Works and Open Rules. You may attend the
> talks or the bootcamps or both.
>
> The Boot Camp will spend the morning introducing the 4 Drools technologies:
> Expert, Fusion, Flow and Guvnor and will additionally cover what's new in
> Drools 5.1. We will also discuss the plans for jBPM3, jBPM4 and Drools Flow.
> The afternoon will be an open floor where you can get time with us core
> developers for any questions, mentoring or assistance that you would like.
>
> Thanks
> Drools 5.1 wouldn't have been possible without the following people:
>
> Core:
> Mark Proctor
> Edson Tirelli
> Kris Verlaenen
> Toni Rikkola
> Geoffrey De Smet
> Jervis Liu
>
> Community:
> Antoine Toulm
> Wolfgang Laun
> Nicolas Héron
> Hadrian Zbarcea
> Tihomir Surdilovic
> Pablo Nussembaum
> Lucaz Amador
> Esteban Aliverti
> Diego López León
> Mauricio Salatino
>
>
> _______________________________________________
> rules-dev mailing list
> rules-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/rules-dev
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/rules-dev/attachments/20100907/da9ac54f/attachment-0001.html