14 Replies Latest reply on Jan 10, 2012 8:44 AM by zino

    jBPM Javadocs

    zino

      I'm trying to locate the full javadocs for the jBPM suite. The javadoc referenced under http://docs.jboss.org/jbpm/v5.2/javadocs contains packages from the org.drools namespace. There is nothing detailing org.jbpm.*.  I did a mvn javadoc:javadoc on the jBPM sources but that generated a lage number independent of javadoc collections (one per maven project).

       

      How can I build a complete javadoc collection containing both org.drools and org.jbpm?

        • 1. Re: jBPM Javadocs
          zino

          A little more playing around with Maven, ...

           

            $ mvn javadoc:aggregate

           

          This builds a single javadoc collection of the org.jbpm.* packages.  All I need to do now is to pull in the org.drools content in.

          • 2. Re: jBPM Javadocs
            mailformrx

            Hi Stephen

             

            It would be great if you could share the javadocs. I am new to JBPM and maven and hence it would be helpful if you could share the java docs in the forum or through the email.

             

            Thanks

            Rajesh

            • 3. Re: jBPM Javadocs
              zino

              Rajesh

               

              I'm working on it - still dealing with the linking to drools content - but when I get something useful I'll let you know.

              Just a heads up - org.jbpm.** has no package documentation at all. Documentation inside packages is limited.

               

              Cheers, Steve.

               

              UPDATE:

               

              A zipped archive of the org.jbpm packages is attached. It is an aggregated javadoc of all of the jbpm packages in the source download built with a link to the published drools packages (however, there appear to be some missing drools packages - as such, some of the links will be broken, e.g. org.jbpm.compiler.ProcessBuilderImpl references classes in the org.drools.compiler package which is not included in the drools javadoc).

               

              /SJM

              • 4. Re: jBPM Javadocs
                zino

                UPDATE/2::

                 

                Have just completed the following:

                 

                1. a github account creation
                2. a fork of the https://github.com/droolsjbpm/jbpm repository into a new github repo
                3. a clone of the forkede repo to my local machine
                4. an update (on my local clone) of the top-level pom to include some structure to the javadoc generation
                5. resolution of a handful of javadoc errors in the source code
                6. fixing tag recognition to removed 500+ javadoc compilation errors
                7. committed my changes to my local clone
                8. pushed local clone chances back to my forked repository
                9. issued a pull request for the integration of my fork changes into the jbpm master repository

                 

                If this gets accepted it means that we have:

                 

                1. a buildable javadoc for the org.jbpm packages linked to the core java and drools javadoc
                2. a structured index page with a breakdown covering:
                  1. BPMN
                  2. Compiler
                  3. Console
                  4. Process
                  5. Ruleflow
                  6. Task
                  7. Workflow
                  8. Other Packages
                3. one example package documentation using a package-info.java source file (under org.jbpm.process.audit)

                 

                I've attached the javadoc generated from the proposed changes. If you take a look you will see that we still have a way to go on package, class and method documentation -- but this is a start. If you want to contribute - you don't need permission - just fork, clone, make your changes, commit, push, and issue a pull request.

                 

                Cheers, Steve.

                • 5. Re: jBPM Javadocs
                  salaboy21

                  Hi Stephen! That sounds amazing.. I will take a look on the pull request now.

                  Cheers

                  • 6. Re: jBPM Javadocs
                    mailformrx

                    Hi Stephen,

                     

                              Thanks.

                     

                     

                     

                    Cheers

                    • 7. Re: jBPM Javadocs
                      zino

                      Mauricio:

                       

                      I liike the github process - register, fork, clone, update, commit, push and post a pull request.

                       

                      What's the usual turnaround time on that last step?

                       

                      Cheers, Steve.

                      • 8. Re: jBPM Javadocs
                        salaboy21

                        That's the way to go, now you should wait to someone merge the pull request.. It usually takes some time if the team is busy fighting against a release

                        • 9. Re: jBPM Javadocs
                          salaboy21

                          That's why I post a comment in the pull request.. to just make them easy the work of merging your stuff.. The idea behind pull requests is that the rest of the community members can validate the source code that other members posts..

                          Cheers

                          • 10. Re: jBPM Javadocs
                            zino

                            ETA (based on the mean of past newbie endeavours)?

                            • 11. Re: jBPM Javadocs
                              salaboy21

                              It really depends on the avalability of the team.. I will do my best to push them to merge your pull request. And it also depends if you fix a bug that can cause big issues.

                              • 12. Re: jBPM Javadocs
                                zino

                                The quality of our documentation is a big issue.

                                • 13. Re: jBPM Javadocs
                                  salaboy21

                                  Of Course!

                                  • 14. Re: jBPM Javadocs
                                    zino

                                    I.e. a *really* *big* issue.