diff --git a/README.md b/README.md index 5a4524d6ec76..5f6e2a1244b9 100644 --- a/README.md +++ b/README.md @@ -2,8 +2,6 @@ Jenkins logo -# About - [![Jenkins Regular Release](https://img.shields.io/endpoint?url=https%3A%2F%2Fwww.jenkins.io%2Fchangelog%2Fbadge.json)](https://www.jenkins.io/changelog) [![Jenkins LTS Release](https://img.shields.io/endpoint?url=https%3A%2F%2Fwww.jenkins.io%2Fchangelog-stable%2Fbadge.json)](https://www.jenkins.io/changelog-stable) [![Docker Pulls](https://img.shields.io/docker/pulls/jenkins/jenkins.svg)](https://hub.docker.com/r/jenkins/jenkins/) @@ -11,6 +9,25 @@ [![Reproducible Builds](https://img.shields.io/badge/Reproducible_Builds-ok-green)](https://maven.apache.org/guides/mini/guide-reproducible-builds.html) [![Gitter](https://img.shields.io/gitter/room/jenkinsci/jenkins)](https://app.gitter.im/#/room/#jenkinsci_jenkins:gitter.im) +--- + +# Table of Contents + +- [About](#about) +- [What to Use Jenkins for and When to Use It](#what-to-use-jenkins-for-and-when-to-use-it) +- [Downloads](#downloads) +- [Getting Started (Development)](#getting-started-development) +- [Source](#source) +- [Contributing to Jenkins](#contributing-to-jenkins) +- [News and Website](#news-and-website) +- [Governance](#governance) +- [Adopters](#adopters) +- [License](#license) + +--- + +# About + In a nutshell, Jenkins is the leading open-source automation server. Built with Java, it provides over 2,000 [plugins](https://plugins.jenkins.io/) to support automating virtually anything, so that humans can spend their time doing things machines cannot. @@ -39,16 +56,26 @@ For all distributions Jenkins offers two release lines: Older release line which gets periodically updated via bug fix backports. Latest releases: + [![Jenkins Regular Release](https://img.shields.io/endpoint?url=https%3A%2F%2Fwww.jenkins.io%2Fchangelog%2Fbadge.json)](https://www.jenkins.io/changelog) [![Jenkins LTS Release](https://img.shields.io/endpoint?url=https%3A%2F%2Fwww.jenkins.io%2Fchangelog-stable%2Fbadge.json)](https://www.jenkins.io/changelog-stable) +# Getting Started (Development) + +For more information on setting up your development environment, contributing, and working with Jenkins internals, check the [contributing guide](CONTRIBUTING.md) and the [Jenkins Developer Documentation](https://www.jenkins.io/doc/developer/). + # Source Our latest and greatest source of Jenkins can be found on [GitHub](https://github.com/jenkinsci/jenkins). Fork us! # Contributing to Jenkins -Follow the [contributing guidelines](CONTRIBUTING.md) if you want to propose a change in the Jenkins core. +New to open source or Jenkins? Here’s how to get started: + +- Read the [Contribution Guidelines](CONTRIBUTING.md) +- Check our [friendly issues](https://issues.jenkins.io/issues/?jql=labels%20%3D%20newbie-friendly%20AND%20resolution%20is%20empty%20AND%20component%20%3D%20core) +- Join our [Gitter chat](https://app.gitter.im/#/room/#jenkinsci_newcomer-contributors:gitter.im) for questions and help + For more information about participating in the community and contributing to the Jenkins project, see [this page](https://www.jenkins.io/participate/). @@ -56,18 +83,37 @@ Documentation for Jenkins core maintainers is in the [maintainers guidelines](do # News and Website -All information about Jenkins can be found on our [website](https://www.jenkins.io/). -Follow us on [Twitter](https://twitter.com/jenkinsci) or [LinkedIn](https://www.linkedin.com/company/jenkins-project/). +All information about Jenkins can be found on our [official website](https://www.jenkins.io/), including documentation, blog posts, plugin listings, community updates, and more. + +Stay up-to-date with the latest Jenkins news, tutorials, and release notes: + +- [Jenkins Blog](https://www.jenkins.io/blog/) +- [Documentation](https://www.jenkins.io/doc/) +- [Plugins Index](https://plugins.jenkins.io/) +- [Events](https://www.jenkins.io/events/) + +Follow Jenkins on social media to stay connected with the community: + +- [Twitter / X](https://x.com/jenkinsci) +- [YouTube](https://www.youtube.com/@jenkinscicd) +- [LinkedIn](https://www.linkedin.com/company/jenkins-project/) # Governance -See the [Jenkins Governance Document](https://www.jenkins.io/project/governance/) for information about the project's open governance, our philosophy and values, and development practices. -Jenkins Code of Conduct can be found [here](https://www.jenkins.io/project/conduct/). +The Jenkins project is governed by an open source community. +To learn more about the governance structure, project leadership, and how decisions are made, visit the [Governance Page](https://www.jenkins.io/project/governance/). # Adopters -Jenkins is used by millions of users and thousands of companies. -See [adopters](https://www.jenkins.io/project/adopters/) for the list of Jenkins adopters and their success stories. +Jenkins is trusted by **millions of users** and adopted by **thousands of companies** around the world — from startups to enterprises — to automate their software delivery pipelines. + +Explore the [Adopters Page](https://www.jenkins.io/project/adopters/) and https://stories.jenkins.io to see: + +- Companies and organizations using Jenkins +- Success stories and case studies +- How Jenkins is used in different industries + +> If your company uses Jenkins and you'd like to be featured, feel free to [submit your story](https://www.jenkins.io/project/adopters/contributing/#share-your-story)! # License