jenkins.io
jenkins.io copied to clipboard
Use concepts from 'Splitting a big job into smaller jobs' for Pipeline conversion guidelines page
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:

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.