[jboss-jira] [JBoss JIRA] (JBRULES-3342) Incorrect/Misleading Expert Documentation For Drools XML Language

[RH Bugzilla Integration (JIRA)]

    [ https://issues.jboss.org/browse/JBRULES-3342?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12668774#comment-12668774 ] 

RH Bugzilla Integration commented on JBRULES-3342:
--------------------------------------------------

Lee Carlon <lcarlon at redhat.com> made a comment on [bug 773693|https://bugzilla.redhat.com/show_bug.cgi?id=773693]


                
> Incorrect/Misleading Expert Documentation For Drools XML Language
> -----------------------------------------------------------------
>
>                 Key: JBRULES-3342
>                 URL: https://issues.jboss.org/browse/JBRULES-3342
>             Project: Drools
>          Issue Type: Bug
>      Security Level: Public(Everyone can see) 
>          Components: drools-docs-expert
>    Affects Versions: 5.0.1.FINAL, 5.1.1.FINAL, 5.2.0.Final, 5.3.1.Final, 5.4.0.Beta1
>         Environment: None - this a documentation issue
>            Reporter: Justin Holmes
>            Assignee: Mark Proctor
>              Labels: docs, expert, xml
>
> The Drools XML language "...has not been developed since drools 4.0, and is considered a deprecated feature." However, the docs for 5.x versions of Drools clearly state, "All the features are available with XML that are available to DRL." As such,the docs need to be updated to reflect the current state of the XML language so users are not mislead.
> A simple yellow Warning box at the beginning of the XML section stating that the XML hasn't been developed since 4.0 and is consider deprecated will be enough to properly inform users. Removing the "All features..." would be useful as well. 
> I'm planning to provided a pull request in the next week or so.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.jboss.org/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira