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

Problem with the "End-to-End Multibranch Pipeline Project Creation" page:

The end to end multibranch Pipeline project creation tutorial fails with git client plugin 4.0.0 and blue ocean plugin 1.26.0. It works with git client plugin 3.13.1 and blue ocean plugin 1.26.0.

Screenshots

Possible Workaround

Install git client plugin 3.13.1 and git plugin 4.14.3 instead of the default versions.

More details

See JENKINS-70379 for more details on the problem and the alternatives to be considered.

#5274 Changes : Part 1

Navbar: changed color to white, changed background Header, Footer: changed background Footer: corrected github icon color to match new background Changed button colors from red to blue to for better contrast and sync

Motivation

• Learn Jenkins by contributing to the repository.
• Draft a proposal for GSoC 2023.

Objective

• Build the repository locally.
• Make significant contributions to this PR.

Problem

The output logs for:

sudo make clean
sudo make prepare
sudo make run

This PR contains the following updates:

| Package | Update | Change | |---|---|---| | haml | minor | '~> 5.1.0' -> '~> 5.2.0' |

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

• [ ] If you want to rebase/retry this PR, check this box

This PR has been generated by Mend Renovate. View repository job log here.