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

Migrate 'Architecture' from wiki to docs site pages

Open getJv opened this issue 5 years ago • 0 comments

Essential information

Page to Migrate: https://wiki.jenkins.io/display/JENKINS/Architecture

Stapler Section

Compare the Stapler section of the Wiki page with the "Request Handling", "Routing requests" section. Include additional materials from the Stapler section of the wiki page in the docs site page.

Views Section

Compare the Views section of the wiki page with the "Views" section on the jenkins.io docs site. Update the docs site with information that is in the wiki page and missing from the docs site.

Persistence Section

Compare the Persistence section of the wiki page with the Persistence page on the jenkins.io docs site. Update the docs site with information that is in the wiki page and missing from the docs site. Consider including content from the "hints on backward compatibility" in the persistence page.

Plugins Section

Compare the Plugins section of the wiki page with the pages in the plugin development section of the docs site. Update the docs site with information that is in the wiki page and missing from the docs site.

Terminology updates

While reviewing all those sections, please consider updating some old terminologies:

  • Change ‘master’ to ‘controller’
  • Change ‘slave’ to ‘agent’

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 the migration is complete, a redirect should be setup to point this page to https://www.jenkins.io/doc/developer/architecture/ 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 21:09 getJv