Fixes #4718.

Add simple left side navigation list to dev docs to improve layout.

Currently, visually the new dev docs layout looks like the following:

I will probably need more time to get familiar with the codebase as well as how asciidoc works before I submit more PRs incrementally for participating in hacktoberfest this year.

Not complete as this would require updating the automated version selection algorithm. Not going to bother with that unless and until there is consensus that we should make this policy change.

Amends #3655; see https://github.com/jenkins-infra/jenkins.io/pull/3643#discussion_r475615780, https://github.com/jenkins-infra/jenkins.io/pull/3630#issuecomment-673936640, https://github.com/jenkinsci/pipeline-maven-plugin/pull/368#issuecomment-917961546, https://github.com/jenkinsci/archetypes/pull/376#discussion_r781199364, https://github.com/jenkinsci/git-plugin/pull/1212#issuecomment-1025850967, etc.

We have not been able to consistently get plugins at the bottom of the food chain to use 2.xxx.1 dependencies. In a number of cases it would not even make sense, because a subsequent security advisory (typically 2.xxx.2 or 2.xxx.3) involved material changes in behavior that affects functional tests.

Problem with the Jenkins download and deployment page, source file

503 Service Temporarily Unavailable is seen when the windows download links are clicked. URL: https://get.jenkins.io/windows/2.266/jenkins.msi

Screenshots

TODO: Add screenshots if possible

Possible Solution

Files may be missing:

Signed-off-by: reveurguy [email protected]

Made initial improvements to the website. Made changes to :

1. navbar spacing, font-size and background
2. footer background
3. banner background and spacing
4. fonts on the site
5. carousel background

Just submitted the current PoC for author info boxes (INFRA-1359).

• [x] - PoC: layout and user avatars
• [x] - TBD: Author info should not be within the text
• [x] - Finalize styles and move them to CSS. TBD: background, spacing, etc.
• [x] - The section should look nice for the users without info/avatars

Currently it prints the info in the bottom of the blog post:

Full info:

Author info, no logo

No author info:

This pull request closes task https://issues.jenkins.io/browse/WEBSITE-799.

It introduces independent scrolling in the documentation sidebar, which is also made collapsible to facilitate the mobile experience.

Upon expanding the sidebar, the main content gets pushed rightwards, and the footer is shrunk adequately.

An Alternative Approach

Upon expanding, we can overlap the sidebar on the content. This will make the toggling much faster for pages with large content.

Tagging the mentors - @kwhetstone @arpoch

Hi everyone, :wave: I'm a Jenkins newbie, and wanted to contribute to the docs. I created a backups overview draft to solicit feedback on recommended manual and automated strategies, tools: UI ,CLI, plugins, etc. I also recently joined the google group doc forum, so happy to discuss further.

@jenkins-infra/copy-editors , @rtyler

One of the blockers to getting more and better documentation added to jenkins.io has been the lack of an overarching structure into which documentation can fit. This PR attempts to remedy that. It provides the basic structure for a "Jenkins Handbook" into which we can put documentation.

There are a set of chapter folders with section files inside. The chapter and section order are controlled by chapter.yml files. The chapters each differ in structure depending on the intended audience and the area/topics covered. Each index.adoc describes the area, audience, and (planned) structure/style for that chapter.

Suggested scope for this PR: (please provide feedback):

• Structure and intent - Each index.adoc describes the what will be covered in each chapter. If you disagree with what is described, speak up. If you think we have a some chapter and think it should be removed, definitely want to hear that.
• index.adoc copy-editing - yes, please.
• Large gaps - if you think there is an important area or group of topics that do not fit into one of the existing chapters, call it out. Basically, if you consider the existing chapters and say, "Those are all good but we need to document <topic/area> and it just won't fit under any of those headings", say so. Adding new chapters is not hard but it would be worth discussing now.

(Suggested) Out of scope for this PR (feedback welcome, but I'd prefer not to block this PR for it):

• Missing sections or other content aside from index.adoc - this is just the basic structure. Content comes next.
• Chapter order: chapters ordered based on value in chapter.yml files. It is easy to reorder them later.
• Section order - sections in each chapter are ordered based on the list in chapter.yml. It is easy to reorder them.

Thanks for your help!

I am trying to install a plugin to jenkins and apparently it cannot connect to the server

• Ubuntu 18.04.5 LTS (GNU/Linux 4.15.0-112-generic x86_64)
• Jenkins v2.249.3
• Slack Notification v2.43

I tried curl https://updates.jenkins.io/download/plugins/slack/2.43/slack.hpi

Not Found

The document has moved here.

I also tried curl https://get.jenkins.io/plugins/slack/2.43/slack.hpi

502 Bad Gateway

---

nginx/1.19.1

java.io.FileNotFoundException: https://get.jenkins.io/plugins/slack/2.43/slack.hpi at sun.net.www.protocol.http.HttpURLConnection.getInputStream0(HttpURLConnection.java:1896) at sun.net.www.protocol.http.HttpURLConnection.getInputStream(HttpURLConnection.java:1498) at sun.net.www.protocol.http.HttpURLConnection.getHeaderField(HttpURLConnection.java:3061) at java.net.URLConnection.getHeaderFieldLong(URLConnection.java:629) at java.net.URLConnection.getContentLengthLong(URLConnection.java:501) at java.net.URLConnection.getContentLength(URLConnection.java:485) at sun.net.www.protocol.https.HttpsURLConnectionImpl.getContentLength(HttpsURLConnectionImpl.java:412) at hudson.model.UpdateCenter$UpdateCenterConfiguration.download(UpdateCenter.java:1264) Caused: java.io.FileNotFoundException: https://get.jenkins.io/plugins/slack/2.43/slack.hpi at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method) at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:62) at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45) at java.lang.reflect.Constructor.newInstance(Constructor.java:423) at sun.net.www.protocol.http.HttpURLConnection$10.run(HttpURLConnection.java:1950) at sun.net.www.protocol.http.HttpURLConnection$10.run(HttpURLConnection.java:1945) at java.security.AccessController.doPrivileged(Native Method) at sun.net.www.protocol.http.HttpURLConnection.getChainedException(HttpURLConnection.java:1944) at sun.net.www.protocol.http.HttpURLConnection.getInputStream0(HttpURLConnection.java:1514) at sun.net.www.protocol.http.HttpURLConnection.getInputStream(HttpURLConnection.java:1498) at sun.net.www.protocol.https.HttpsURLConnectionImpl.getInputStream(HttpsURLConnectionImpl.java:268) at hudson.model.UpdateCenter$UpdateCenterConfiguration.download(UpdateCenter.java:1280) Caused: java.io.IOException: Failed to load https://updates.jenkins.io/download/plugins/slack/2.43/slack.hpi to /var/lib/jenkins/plugins/slack.jpi.tmp at hudson.model.UpdateCenter$UpdateCenterConfiguration.download(UpdateCenter.java:1287) Caused: java.io.IOException: Failed to download from https://updates.jenkins.io/download/plugins/slack/2.43/slack.hpi (redirected to: https://get.jenkins.io/plugins/slack/2.43/slack.hpi) at hudson.model.UpdateCenter$UpdateCenterConfiguration.download(UpdateCenter.java:1321) at hudson.model.UpdateCenter$DownloadJob._run(UpdateCenter.java:1869) at hudson.model.UpdateCenter$InstallationJob._run(UpdateCenter.java:2147) at hudson.model.UpdateCenter$DownloadJob.run(UpdateCenter.java:1843) at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511) at java.util.concurrent.FutureTask.run(FutureTask.java:266) at hudson.remoting.AtmostOneThreadExecutor$Worker.run(AtmostOneThreadExecutor.java:118) at java.lang.Thread.run(Thread.java:748)

Possible Solution

N/A

Trying out the web components

• [x] active links definitely need refactoring.
• [x] Search box needs to actually be setup

Optional

• [ ] Probably can load it earlier (deferred) so we don't get the flash of a header
• [ ] Probably don't need the polyfills depending on which browers we are okay being degraded and without header/foheader
• [x] Move GitHub orgs
• [ ] use updatecli instead of always linking to recent package on unpkg?

Draft until the plugin is actually released,

PR was: https://github.com/jenkinsci/github-branch-source-plugin/pull/269

cc @bitwiseman @oleg-nenashev @ojacques

Description

When a pull request is made to the jenkins.io repository, a full preview of the site is now available for anyone to view. This preview accurately reflects the final layout of the site, unlike GitHub pages which may not be an exact match. Developers no longer need to maintain separate GitHub pages for this purpose.

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

Follow up from WEBSITE-426

At this time, the Manage User page is empty and contains no relevant information. This page should either be removed, if other pages provide this information, or updated to have content so that it is not a blank page.

Links

Manage Users page

Follow up from WEBSITE-424

At this time, the system configuration page does not contain any information. This page should either be removed if other pages provide this information, or filled out if this page should have content.

Links

https://www.jenkins.io/doc/book/managing/system-configuration/

Following up from WEBSITE-734

It would be great to have a C/C++ tutorial similar to the other build tools. There are currently tutorials for Maven, Python, and Node JS.

Links

Build Tool tutorials