Details

    • Type: Task
    • Status: To Do (View Workflow)
    • Priority: Major
    • Resolution: Unresolved
    • Component/s: content
    • Labels:
      None
    • Similar Issues:

      Description

      Giles Gaskell and I were just talking about this and couldn't figure out the logic behind all the terms.

      What exactly is the difference/definition of the following things in Declarative Pipeline:

      • Section
      • Directive
      • Options
      • "helper method"
      • Step
      • Argument
      • Conditions
      • Parameter

      There are a lot of different things in https://github.com/jenkins-infra/jenkins.io/blob/master/content/doc/book/pipeline/syntax.adoc and it is unclear what the differences are.   We should be specific their definitions.

       

        Attachments

          Issue Links

            Activity

            Hide
            bitwiseman Liam Newman added a comment -

             

            Andrew Bayer R. Tyler Croy

            Do you have any thoughts on this? 

             

            Show
            bitwiseman Liam Newman added a comment -   Andrew Bayer R. Tyler Croy Do you have any thoughts on this?   
            Hide
            ggaskell Giles Gaskell added a comment - - edited

            Just to add my 2c worth, when attempting to distinguish between a section and a directive, Liam Newman and I noticed that all directives (with the sole exception of the steps section), cannot accept a section.

            Would it be worthwhile reclassifying steps as a directive instead of a section or would this be wrong? If wrong, why?

            Another thing I noticed (and I'm not sure if this is true so I'd be grateful for clarification) is that the contents of a section appears to be processable in multiple transactions, whereas the contents of a directive appears to be processed in/as a single transaction only.
            Would this be true (or a better explanation for distinguishing a directive from a section)?

            Show
            ggaskell Giles Gaskell added a comment - - edited Just to add my 2c worth, when attempting to distinguish between a section and a directive , Liam Newman and I noticed that all directives (with the sole exception of the steps section), cannot accept a section . Would it be worthwhile reclassifying steps as a directive instead of a section or would this be wrong? If wrong, why? Another thing I noticed (and I'm not sure if this is true so I'd be grateful for clarification) is that the contents of a section appears to be processable in multiple transactions, whereas the contents of a directive appears to be processed in/as a single transaction only. Would this be true (or a better explanation for distinguishing a directive from a section )?

              People

              • Assignee:
                Unassigned
                Reporter:
                bitwiseman Liam Newman
              • Votes:
                0 Vote for this issue
                Watchers:
                2 Start watching this issue

                Dates

                • Created:
                  Updated: