Uploaded image for project: 'Jenkins'
  1. Jenkins
  2. JENKINS-57539

Prepare design document for a top level architecture

XMLWordPrintable

    • GSoC 2019. Community Bonding

      This issue is about preparing a design document of a top level architecture for the plugins that will be developed in the 'Multibranch Pipeline Support for GitLab' Project.

      • Objectives and expectations based on proposal
      • Answer questions such as
        • "How is the user going to use this?",
        • "What configurations are needed?", 
        • "What are the components of the plugin?"
      • Create diagrams of API
      • Write mini user guides as if project is already done

      After completion, reality mapping shall be done through a discussion with the key stakeholders in Branch Source Plugins.

          [JENKINS-57539] Prepare design document for a top level architecture

          Mark Waite added a comment -

          There are several good documents available that can be used as the starting point, including:

          Mark Waite added a comment - There are several good documents available that can be used as the starting point, including: Branch API Implementation Guide Branch API User Guide SCM API Implementation Guide SCM API Consumer Guide Branches and Pull Requests in the Jenkins User Handbook Practical Guide to CI with Jenkins and GitHub - GitHub White Paper Pipeline Fundamentals course from CloudBees (with large sections on multibranch Pipelines and their use)

          Parichay Barpanda added a comment -

          Thanks Mark. I was already referring to the SCM API and BRANCH API docs. They are verbose and gives a nice picture of how the implementation will be done. I'll check rest of the pointers for more info.

          Parichay Barpanda added a comment - Thanks Mark. I was already referring to the SCM API and BRANCH API docs. They are verbose and gives a nice picture of how the implementation will be done. I'll check rest of the pointers for more info.

          Parichay Barpanda added a comment -

          Some important implementation of classes has been added to the document from the SCM API and Branch API docs. Unfortunately couldn't find more support for design document from any experienced developer of any Branch Source Plugin but with the help of well maintained codebase and javadocs I was able to come up with my versions of implementations idea. The design document doesn't provide a concrete idea of our plugin APIs but it will be updated throughout the course of development. So at the end of the plugin release, this design document will contain all the necessary information a user or other plugin authors require to extend or get inspired.

          Parichay Barpanda added a comment - Some important implementation of classes has been added to the document from the SCM API and Branch API docs. Unfortunately couldn't find more support for design document from any experienced developer of any Branch Source Plugin but with the help of well maintained codebase and javadocs I was able to come up with my versions of implementations idea. The design document doesn't provide a concrete idea of our plugin APIs but it will be updated throughout the course of development. So at the end of the plugin release, this design document will contain all the necessary information a user or other plugin authors require to extend or get inspired.

          Marky Jackson added a comment -

          Per team agreeable, this document is meeting acceptance. baymac says he would like to add a few more items to this body of work. I will leave open until then but it is agreed that this can be closed once that is done.

          Marky Jackson added a comment - Per team agreeable, this document is meeting acceptance. baymac says he would like to add a few more items to this body of work. I will leave open until then but it is agreed that this can be closed once that is done.

            baymac Parichay Barpanda
            baymac Parichay Barpanda
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: