2 Replies Latest reply on Aug 12, 2015 2:43 PM by SANJAY GAUTAM

    Hard time getting started

    Bob Searles Newbie

      I am having the hardest time getting started with jBPM.  I think it is one reason adoption has not been greater and users are starting to defect; despite a solid product.  The documentation is not user friendly.


      - Googling 'jBPM documentation' gives a link to 6.0 version, not the current 6.2 version.  Googling 'jBPM getting started' brings you to a 5.1 version document.  Of course search rank is mostly out of control of a content provider, but it would help if older versions of docs and bits were tucked away in less accessible locations for search engines to find.  In general, there is a lot of outdated information on jboss' site and many other locations.

      - Documentation is thick and inconsistent.  Seems that every sentence written has a link in the index.  The index has links, to sub-indexes with more links.  Need to consider usability and enabling first-time readers to get the big picture.  You don't need 7 links under the section '2.5 Getting Involved', just have a link to the '2.5 Getting Involved' section only.  With so many links and links to lists of links, it is easy to get lost and lose the big picture.  Someone has taken perfectionist tendencies too far.

      - Eclipse jBPM project type not working properly.  Creating a new jBPM project does not create any class which has code to execute.  Tried various combinations of 'jBPM project' and 'jBPM project (Maven)' and 'a simple hello world process' and all the other options.  None of them work (at least for me).  The 'jBPM project' with 'a simple hello world process' will generate ProcessTest.java, but not bpmn file, and 'import org.jbpm.test.JbpmJUnitBaseTestCase' is not recognized so the class has many other errors.

      - Unsuccessful when trying to start with an empty plain java project (with Maven).  Brought in dependencies (why ArtifactId of jbpm-test or jbpm-bpmn2 instead of something like jbpm-core?).  Started with vanilla project, then added jBPM maven dependencies, then wrote in my main code from '5.2 KieBase' then added code from '5.3 KieSession'.  That didn't work.  It is not clear if the "com.sample.MyProcess" is the class that was created from the compiled "MyProcess.bpmn" in the previous step.  I tried adding a MyProcess.bpmn file that had "MyProcess" as the "id" of the "process" node.  But no success.  I'm sure there is a simple solution and it is evident for someone who is familiar with the library, but not for newcomers.

      - There are 178 artifacts on Maven Central for "org.jbpm".  I think these should be packaged at a higher level rather than something like "jbpm-console-ng-workbench-integration-client".  I understand that is to give the maximum amount of modularity.  But it also prevents the project's adoption.  Similar to the links of links, I think this is evidence of perfectionist tendencies too far.


      I know this is a rant, but I am taking the time to write it because I want the jBPM project to flourish.  I want to believe in it.  I want to use it.  But am just frustrated by how hard it is to navigate.  I'm worried that others are too, and have never taken the time to write about it.  Leading to youtube videos titled "JBpm 6.... Um, no thanks."  This reminds me of the evolution of SOAP.  At a tipping point of complexity, simpler services like REST took off, and now that is the preferred mechanism for web services.  It appears that the Activiti project was started out of similar frustrations with jBPM.  I hope jBPM doesn't lose out to simplified projects like SOAP did to REST.

        • 1. Re: Hard time getting started
          Maciej Swiderski Master



          thanks for sharing your thoughts on this. We are aware of lacking in the docs and that some of them are outdated and trying to come with some solution but that's not easy as we have limited resources for it.

          So I'd like to suggest to have some sort of cooperation with community on this. All core developers are at IRC channels and can assist with all types of tasks. Would you be interested in contribution to the project in like helping out clean and simplify getting started sections of the documentation with some examples?


          I'd me more than happy to help with this but would like to see this as contribution as this way we won't miss important pieces (as compared to what would happen when done by core developer who knows it rather well and by that assumes everyone knows it).


          What do you think?

          • 2. Re: Hard time getting started
            SANJAY GAUTAM Expert

            Hi Maciej


            I have similar thoughts, the main issue is that to  get the whole perspective/bigger picture, the information about the structure and architecture of the code base , so that any one can start working in the area of interest like , if one like web he can work on Kie Work Bench , rather than back end and so on .


            I have seen that there are some BPMN unit test cases but they definitely embedded inside too deep. I had been working on it last six month and still dont get confidence that this BPMN I would like to have it in PROD anytime soon. there are something simple like i asked question earlier like if i deploy a unit test case it throws  error etc. over all I am trying to understand how to start and help you in this regards , but there has to be certain level of information needed before he/she can contribute  but that certain information is quiet hard to get. hope you get what I am trying to say. Just like Bob I also want to see it successful, but all the stories which I have heard is that people have moved away from JBPMN after little struggle .



            Sanjay Gautam