Pipeline Syntax page - Wrong documentation

[KES777]

Problem with the Pipeline Syntax page, source file

Screenshots

I see some SO answers refer here, but args does not work =( https://stackoverflow.com/a/46359650/4632019

[KES777]

But next documentation mentions args but did not provide example:

[dduportal]

Thanks for opening this issue ! The « args » are provided to the « docker run » command that starts the container in which the steps are run. But the additionalBuildArgs are the arguments provided to the « docker build » command that preceds the aformentioned « docker run ».

[KES777]

Yes, I understand. Just complain that args example does not have something like:

    dockerfile {
        docker ...
        args ...
    }

but first example does not describe about args but have that option at example

[dduportal]

Fair. Are you willing to provide an updated example for the « docker {} » agent case? You can do it directly from your webbrowser by scrolling down on the page and click on « improve this page », which open a text editor directly in github web ui

[KES777]

sorry, I am a new user, so can do wrong things. Just point places which I did not understand

[dduportal]

sorry, I am a new user, so can do wrong things. Just point places which I did not understand

No problem, and many thanks for pointing it!

I'm proposing that you author this documentation change for 2 reasons:

• Your report is legit, make sense and is valuable, so as an Open Source maintainer, I really like to give credit to people's contribution. And you are doing a contribution here: it helps a lot!
• "you know what you don't know": there is no person best suited than you to propose a change to such a documentation. Most of us, maintainers, are using Jenkins since a long time, so we forgot what it's like to get started. Any line I could write would be bad, while you, with a newcomer eye, have the best feedbacks for improvement!

No worries: if you are not willing to propose the change, or if you do not feel like to do it, then we'll try to do it on our own: in that case we'll still mention you on the pull request, so you can review it and give us guidance! Which solution would be the best to you?

[KES777]

If I done my configuration successfully then I try to fix documentation. Currently I stuck