Details
-
Task
-
Resolution: Won't Do
-
Minor
-
6.2.0.Final
-
None
-
None
Description
Keeping track that we need to do this.
Problem description:
The JD quickstart for business resource planner https://github.com/jboss-developer/jboss-brms-quickstarts/tree/6.1.x/business-resource-planner which is being delivered to our customers as the BRP tutorial, copy pasted a lot from the community examples optaplanner-webexamples https://github.com/droolsjbpm/optaplanner/tree/6.2.x/optaplanner-webexamples The reuse of that VRP example in the JD quickstart is a good thing, but the manner of reuse (copy-pasting) is not. Because the code was copy-pasted, no new fixes or features on upstream optaplanner-webexamples are ever applied on the JD quickstart. We are now receiving bug reports for bugs that are already fixed upstream: https://bugzilla.redhat.com/show_bug.cgi?id=1229175 So the JD quickstart is effectively stale. How do we fix this process? Some proposals: A) Remove the JD quickstart: First salvage the best parts from the JD quickstart and put them in optaplanner-webexamples. B) Fix the JD quickstart: Import optaplanner-webexamples code (of the productized version of course) and remove duplicated code. C) Do duplicate work: fix every issue on optaplanner-webexamples and then duplicate that effort towards the JD quickstart. D) Do nothing: let the JD quickstart continue to become utterly stale, causing confusing with users, ruining JD's and BRMS's reputations.
Additional reqs to keep in mind:
Because quickstarts were designed to be simple, focusing on a single use case and could be delivered independently, the VRP example had to be "adapted" to follow the quickstarts guidelines. You can read more about those guidelines here: https://mojo.redhat.com/docs/DOC-1008312 I made a query at JBossDeveloper Materials page about "planner" quickstart ( http://www.jboss.org/developer-materials/#!formats=demo&query=planner&sys_type=quickstart ) and the only reference found was the business-resource-planner quickstart ( http://www.jboss.org//quickstarts/brms/business-resource-planner/index.html ). That's the kind of promotion that we were trying to bring to the product. Yes! I also downloaded the planner engine from Customer Portal and the optaplanner-webexamples folder is also there to help promoting the product but without visibility in http://www.jboss.org. Having said that, my suggestion to have the best of both worlds is B) Fix the JDG quickstart: Import optaplanner-webexamples code (of the productized version of course) and remove duplicated code. This should be execute by someone in BRMS/BPMS team once that I also don't have work bandwidth to do that.