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

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.