jenkins.io icon indicating copy to clipboard operation
jenkins.io copied to clipboard

Use concepts from 'Splitting a big job into smaller jobs' for Pipeline conversion guidelines page

Open getJv opened this issue 5 years ago • 0 comments

Essential information

Use the concepts from https://wiki.jenkins.io/display/JENKINS/Splitting+a+big+job+into+smaller+jobs and from other descriptions of the Freestyle to Pipeline conversion process to create a page in the https://www.jenkins.io/doc/book/pipeline/ chapter. The page should guide the user to make good choices as they convert from one or more Freestyle jobs to a Pipeline job. The Pipeline facilities should be highlighted, including those described in "Why Pipeline?".

Terminology updates

Please consider updating some old terminologies:

  • Change ‘master’ to ‘controller’
  • Change ‘slave’ to ‘agent’
  • Change ‘blacklist’ to ‘denylist’ or better phrase in context
  • Change ‘whitelist’ to ‘allowlist’ or better phrase in context

Migration tutorial

Watch the tutorial to learn more about each page migration process: IMAGE ALT TEXT HERE

Additional information

You can use the wiki-exporter to save some time: https://jenkins-wiki-exporter.jenkins.io/

Redirecting pages

After it has been migrated a redirect should be setup, by sending a PR to this file: https://github.com/jenkins-infra/jenkins-infra/blob/staging/dist/profile/templates/confluence/vhost.conf, see past PRs for examples, or just take a look.

getJv avatar Sep 27 '20 18:09 getJv