Add updating Jenkins section in User's Handbook

[Vandit1604]

Windows and Linux sections are based on my knowledge and @krisstern helped in macOS section for upgrading jenkins other than that every thing is compiled by me after reading blogs and questions answered on community forum of jenkins
feel free to add upgrading instructions for other sections
this closes #5059

[krisstern]

Hi @Vandit1604 Try adding a file with your GitHub username as the file name in here for the authors: https://github.com/jenkins-infra/jenkins.io/tree/master/content/_data/authors

[Vandit1604]

@krisstern Hi I created this PR #5890 doing what you instructed
thanks for your time

[krisstern]

Maybe it would be better originally to have the changes you made in PR #5890 to this PR instead. Now you will have to wait until that PR is merged and pull the latest changes to this PR later before every check is passed.

[Vandit1604]

I can close that PR #5890 and commit the changes to this PR so this can be merged/reviewed much faster

[krisstern]

Sure

[krisstern]

@Vandit1604 It appears there are some bugs to be patched before the checks are passed:

[2023-01-07T14:30:23.323Z] Failing build due to warnings in log output:

[2023-01-07T14:30:23.323Z] asciidoctor: WARNING: doc/book/updating/_update-wizard.adoc: line 16: section title out of sequence: expected level 2, got level 4

[2023-01-07T14:30:23.323Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/download/index.html.haml:156: warning: calling URI.open via Kernel#open is deprecated, call URI.open directly or use URI#open

[2023-01-07T14:30:23.323Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/download/index.html.haml:97: warning: calling URI.open via Kernel#open is deprecated, call URI.open directly or use URI#open

[2023-01-07T14:30:23.323Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/_layouts/corebaseline.html.haml:9: warning: calling URI.open via Kernel#open is deprecated, call URI.open directly or use URI#open

[2023-01-07T14:30:23.323Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/_partials/changelog-changes.xml.haml:11: warning: Using the last argument as keyword parameters is deprecated

[2023-01-07T14:30:23.323Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/_partials/changelog-changes.xml.haml:13: warning: Using the last argument as keyword parameters is deprecated

[2023-01-07T14:30:23.323Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/_partials/changelog-changes.xml.haml:15: warning: Using the last argument as keyword parameters is deprecated

[2023-01-07T14:30:23.323Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/_partials/changelog-changes.xml.haml:16: warning: Using the last argument as keyword parameters is deprecated

[2023-01-07T14:30:23.323Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/_partials/changelog-changes.xml.haml:17: warning: Using the last argument as keyword parameters is deprecated

[2023-01-07T14:30:23.324Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/_partials/changelog-changes.xml.haml:20: warning: Using the last argument as keyword parameters is deprecated

[2023-01-07T14:30:23.324Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/_partials/changelog-changes.xml.haml:22: warning: Using the last argument as keyword parameters is deprecated

[2023-01-07T14:30:23.324Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/_partials/changelog-changes.xml.haml:24: warning: Using the last argument as keyword parameters is deprecated

[2023-01-07T14:30:23.324Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/_partials/changelog-changes.xml.haml:26: warning: Using the last argument as keyword parameters is deprecated

[2023-01-07T14:30:23.324Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/_partials/changelog-changes.xml.haml:27: warning: Using the last argument as keyword parameters is deprecated

[2023-01-07T14:30:23.324Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/_partials/changelog-changes.xml.haml:28: warning: Using the last argument as keyword parameters is deprecated

[2023-01-07T14:30:23.324Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/_partials/changelog-changes.xml.haml:9: warning: Using the last argument as keyword parameters is deprecated

[2023-01-07T14:30:23.324Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/security/advisories/rss.xml.haml:40: warning: Using the last argument as keyword parameters is deprecated

[2023-01-07T14:30:23.324Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/security/advisories/rss.xml.haml:42: warning: Using the last argument as keyword parameters is deprecated

[2023-01-07T14:30:23.324Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/security/advisories/rss.xml.haml:46: warning: Using the last argument as keyword parameters is deprecated

[2023-01-07T14:30:23.324Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/security/advisories/rss.xml.haml:48: warning: Using the last argument as keyword parameters is deprecated

[2023-01-07T14:30:23.324Z] /home/jenkins/workspace/Websites_jenkins.io_PR-5888/content/security/advisories/rss.xml.haml:52: warning: Using the last argument as keyword parameters is deprecated

[krisstern]

Currently the images are not showing yet in the preview version at https://deploy-preview-5888--jenkins-io-site-pr.netlify.app/doc/book/updating and some pages like the one on Windows appear to need some polish up (like with additional description/explanation for each step added). I will let the @jenkins-infra/copy-editors team to review the PR in more depth.

[Vandit1604]

I'll also correct the heading size as right now the page looks like a mess

[krisstern]

For an example of a working link to images:

[.boxshadow]
image:tutorials/setup-jenkins-02-unlock-jenkins-page.png[alt="Unlock Jenkins page",width=80%]

This is taken from https://raw.githubusercontent.com/jenkins-infra/jenkins.io/master/content/doc/book/installing/windows.adoc

[krisstern]

I'll also correct the heading size as right now the page looks like a mess

Sure, sounds like a good idea

[Vandit1604]

For an example of a working link to images:

[.boxshadow]
image:tutorials/setup-jenkins-02-unlock-jenkins-page.png[alt="Unlock Jenkins page",width=80%]

I have added the images just like that after seeing how images were added in other pages
I'll check it again if the path to the image is broken or some image has the same name

[Vandit1604]

Sorry for the commits
I was resolving some conflicts and didn't realise i was committing old changes too

[krisstern]

You have for the image link now for example: image::/content/images/updating/check-jenkins-version.png[alt="Checking Version of Updated Jenkins Instance",width=80%]

I think it should really be like the following with boxshadow to keep the styling consistent:

[.boxshadow]
image:updating/check-jenkins-version.png[alt="Unlock Jenkins page",width=80%]

[krisstern]

And @Vandit1604 You may want to put your image in here instead: https://github.com/jenkins-infra/jenkins.io/tree/master/content/doc/book/resources

[Vandit1604]

You have for the image link now for example: image::/content/images/updating/check-jenkins-version.png[alt="Checking Version of Updated Jenkins Instance",width=80%]

I think it should really be like the following with boxshadow to keep the styling consistent:

[.boxshadow]
image:updating/check-jenkins-version.png[alt="Unlock Jenkins page",width=80%]

this was how it was before i checked in asciidoctor docs there it is mentioned you can use either (:) or (::) colon but i'll change it to one colon (:)

[krisstern]

You have for the image link now for example: image::/content/images/updating/check-jenkins-version.png[alt="Checking Version of Updated Jenkins Instance",width=80%]
I think it should really be like the following with boxshadow to keep the styling consistent:

[.boxshadow]
image:updating/check-jenkins-version.png[alt="Unlock Jenkins page",width=80%]

this was how it was before i checked in asciidoctor docs there it is mentioned you can use either (:) or (::) colon but i'll change it to one colon (:)

Look I gave you the exact path you are supposed to use, in a folder called updating within the path content/doc/book/resources. Please be careful with reading the instruction. I was not suggesting just a symbol change.

[krisstern]

@Vandit1604 The paths you are using are currently all broken paths.

[Vandit1604]

Look I gave you the exact path you are supposed to use, in a folder called updating within the path content/doc/book/resources. Please be careful with reading the instruction. I was not suggesting just a symbol change.

Sorry
I have committed the correct path now

[Vandit1604]

Given the current level of traction on this PR, I believe it may be best to close it for now. I am happy to revisit and continue working on it in the future should the need arise.