diff --git a/content/_data/indexpage/carousel.yml b/content/_data/indexpage/carousel.yml index 7f943793ae6e..1cc82ca26e32 100644 --- a/content/_data/indexpage/carousel.yml +++ b/content/_data/indexpage/carousel.yml @@ -1,3 +1,15 @@ +# Hacktoberfest 2024 +- :href: https://hacktoberfest.com/ + :title: Hacktoberfest 2024 + :intro: Jenkins is participating in Hacktoberfest 2024. We are seeking contributors + and maintainers who want to join us to improve Jenkins in October! + :image: + :src: /images/hacktoberfest/hacktoberfest_2024_social_600x300.png + :height: 300px + :call_to_action: + :text: More info + :href: "/events/hacktoberfest/" + # Jenkins 2024 board and officer elections - :href: /blog/2024/09/25/board-officer-election-announcement/ :title: Voter registration for Jenkins Elections 2024 diff --git a/content/blog/2024/09/2024-09-30-hacktoberfest.adoc b/content/blog/2024/09/2024-09-30-hacktoberfest.adoc new file mode 100644 index 000000000000..0a4f3ee396f7 --- /dev/null +++ b/content/blog/2024/09/2024-09-30-hacktoberfest.adoc @@ -0,0 +1,63 @@ +--- +layout: post +title: "Hacktoberfest 2024" +tags: +- hacktoberfest +- event +- community +- newcomer +- outreach-programs +author: markewaite +links: + discourse: https://community.jenkins.io/t/hacktoberfest-2024/20812 +opengraph: + image: /images/hacktoberfest/hacktoberfest_2024_social.jpg +--- + +image:/images/hacktoberfest/hacktoberfest_2024_logo.svg[Hacktoberfest, role=center, width='75%'] + +link:https://hacktoberfest.com[Hacktoberfest] is back! +Join us as we celebrate and support open-source during October. +Contributors can earn badges and improve their open source contribution skills. + +The Jenkins community will participate once again in the event. +We invite you to contribute to Jenkins projects but also, as maintainers, to welcome and help newcomers. + +== Contributors + +This is what **contributors** need to know to participate and complete Hacktoberfest: + +- Register anytime between September 23 and October 31 +- Pull requests can be made in any link:https://github.com/orgs/jenkinsci/repositories?q=hacktoberfest[jenkinsci] or link:https://github.com/orgs/jenkins-infra/repositories?q=hacktoberfest[jenkins-infra] GitHub project that's participating in Hacktoberfest (look for the "hacktoberfest" topic) +- Project maintainers must accept your pull requests for them to count toward your total +- Have 4 pull requests accepted between October 1 and October 31 to complete Hacktoberfest + +Jenkins specific details can be found on the link:/events/hacktoberfest[Jenkins Hacktoberfest page]. + +Some good resources for beginners can be found here: + +* Intro to Open Source +** DigitalOcean: link:https://www.digitalocean.com/community/tutorial_series/an-introduction-to-open-source[Introduction to GitHub and Open Source projects] +** GitHub: link:https://opensource.guide/how-to-contribute/[How to contribute to Open Source] +** DigitalOcean: link:https://www.digitalocean.com/community/tutorials/what-is-open-source[What is Open Source] +** DigitalOcean: link:https://www.digitalocean.com/community/cheatsheets/how-to-use-git-a-reference-guide[How to use Git] +* Sharpen your skills +** link:https://github.github.com/training-kit/[GitHub training kit] +** link:https://guides.github.com/introduction/flow/[Understanding the GitHub flow] +** link:https://www.digitalocean.com/community/tutorial_series/an-introduction-to-open-source[An introduction to Open Source] +** link:https://opensource.com/article/19/5/how-get-job-doing-open-source[How Open Source contributions can boost your career] +** link:https://github.blog/2015-01-21-how-to-write-the-perfect-pull-request/[How to write the perfect Pull Request] +** link:https://dev.to/chrissiemhrk/git-commit-message-5e21[How to write a good commit message] + +The link:/doc/developer/tutorial-improve/[improve a plugin tutorial] is a video introduction to Jenkins contribution. + +== Maintainers + +Jenkins plugin **maintainers** can prepare for Hacktoberfest contributions by following these best practices: + +* Add the "hacktoberfest" topic to your repository to OPT-IN TO HACKTOBERFEST and indicate you're looking for contributions +* Apply the "good first issue" label to issues you want contributors to help with in your GitHub project +* Add a CONTRIBUTING.md file with contribution guidelines to your repository +* Choose issues that have a well-defined scope and are self-contained +* Be ready to review pull requests, accepting those that are valid by merging them, leaving an overall approving review, or by adding the "hacktoberfest-accepted" label +* Reject any spammy requests you receive by labeling them as "spam" and any other invalid contributions by closing them or labeling them as "invalid" diff --git a/content/events/hacktoberfest.adoc b/content/events/hacktoberfest.adoc index fe6e76699a29..451f27b6e8f0 100644 --- a/content/events/hacktoberfest.adoc +++ b/content/events/hacktoberfest.adoc @@ -9,17 +9,16 @@ tags: - programs - hacktoberfest links: - discourse: https://community.jenkins.io/t/hacktoberfest-2023/9613 + discourse: https://community.jenkins.io/t/hacktoberfest-2024/20812 opengraph: - image: /images/hacktoberfest/hacktoberfest_2023_social_600x300.png + image: /images/hacktoberfest/hacktoberfest_2024_social_600x300.png --- -image:/images/hacktoberfest/hacktoberfest_2023_logo.png[Hacktoberfest, role=center] +image:/images/hacktoberfest/hacktoberfest_2024_logo.svg[Hacktoberfest, role=center, width='75%'] -link:https://hacktoberfest.com/[Hacktoberfest] -is a month-long celebration of open source software that happens every October. +link:https://hacktoberfest.com/[Hacktoberfest] is a month-long celebration of open source software that happens every October. During this event, everyone can support open source by contributing changes and earning a unique digital reward. -This year marks the 10th anniversary of Hacktoberfest! +This year marks the 11th anniversary of Hacktoberfest! We invite everyone to participate and contribute to the Jenkins project, regardless of their background and Jenkins experience. There are many ways to link:/participate/[contribute] to Jenkins during Hacktoberfest. @@ -30,41 +29,36 @@ Please refer to the link:/participate/[Contribute and Participate] page for more == Quick start -1. Sign-up to Hacktoberfest on link:https://hacktoberfest.com[the event website]. -2. Join link:https://app.gitter.im/#/room/#jenkinsci_hacktoberfest:gitter.im[our Gitter channel]. -3. Everything is set, just start creating pull requests! +1. Sign-up to Hacktoberfest on the link:https://hacktoberfest.com[event website]. +2. Join our link:https://app.gitter.im/#/room/#jenkinsci_hacktoberfest:gitter.im[Gitter channel]. +3. Everything is set, just start creating pull requests on repositories with the link:https://github.com/search?q=org%3Ajenkinsci+org%3Ajenkins-infra+topic%3Ahacktoberfest&type=repositories[`hacktoberfest` topic]! ** If a repository has no `hacktoberfest` topic set, contact the maintainers to see if they are willing to accept a contribution. ** Alternatively, if a pull request has the label `hacktoberfest-accepted`, it will count towards your total. ** Your pull request must not be labeled as invalid to be counted. -** For your pull requests to be accepted, the request must either be merged, have the `hacktoberfest-accepted` label, or have an overall approving review on GitHub. +** For your pull requests to be accepted, the request must either be merged or have the `hacktoberfest-accepted` label. == Where to contribute? The Jenkins project is spread across two organizations on GitHub: link:https://github.com/jenkinsci/[`jenkinsci`] and link:https://github.com/jenkins-infra/[`jenkins-infra`]. -You are welcome to contribute to *any* repository in *either* of those organizations or any other Jenkins-related repository on GitHub. +You are welcome to contribute to *any* repository with the link:[`hacktoberfest topic`] in *either* of those organizations. Be aware that repositories may have different contribution guidelines, review processes, and merge policies. -If you adopt Jenkins in your open-source projects, such as Jenkins Pipeline or Configuration as Code, this counts as well! Not all pull requests will automatically count towards Hacktoberfest. -Keep in mind, the pull request must either be merged, have the `hacktoberfest-accepted` label, or have an overall approving review on GitHub. +Keep in mind, the pull request must either be merged in a repository with the `hacktoberfest` topic or have the `hacktoberfest-accepted` label. * link:https://github.com/search?q=org%3Ajenkinsci+org%3Ajenkins-infra+topic%3Ahacktoberfest&type=repositories[Repositories marked for Hacktoberfest] - In these repositories you can just submit pull requests, no extra steps are needed. -* For other repositories, we will need to get the repo marked with the topic "Hacktoberfest" for your pull request to count towards the goal. - Please follow link:/events/hacktoberfest/faq/#how-do-i-mark-my-pull-requests[FAQ: Marking Pull requests]. === Issue queries We have marked some issues in Jenkins Jira and GitHub issues which can be handled by contributors during Hacktoberfest: -* link:https://issues.jenkins.io/issues/?jql=labels%20%3D%20hacktoberfest%20and%20status%20in%20(Open%2C%20%22To%20Do%22%2C%20Reopened)[Jenkins Jira issues suggested for Hacktoberfest] -* link:https://github.com/search?q=org%3Ajenkinsci+org%3Ajenkins-infra+org%3Ajenkins-zh+is%3Aissue+is%3Aopen+label%3Ahacktoberfest[GitHub issues suggested for Hacktoberfest] -* link:https://issues.jenkins.io/secure/Dashboard.jspa?selectPageId=19342[Newbie-friendly issue dashboard in Jenkins Jira] -* link:https://issues.jenkins.io/issues/?jql=labels%20%3D%20newbie-friendly%20and%20status%20in%20(Open%2C%20%22To%20Do%22%2C%20Reopened)[Newbie-friendly issues in Jenkins Jira] -* link:https://github.com/search?q=org%3Ajenkinsci+org%3Ajenkins-infra+org%3Ajenkins-zh+is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22[Good first issues on GitHub] +* link:https://issues.jenkins.io/secure/Dashboard.jspa?selectPageId=19342[Newbie-friendly issues in Jenkins Jira] +* link:https://github.com/search?q=org%3Ajenkinsci+org%3Ajenkins-infra+is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22[Good first issues on GitHub] +* link:https://github.com/search?q=org%3Ajenkinsci+org%3Ajenkins-infra+is%3Aissue+is%3Aopen+label%3Ahacktoberfest[GitHub issues suggested for Hacktoberfest] === Featured projects -If you are a newcomer contributor, we have prepared a list of projects/components where you will get a warm welcome. -All these projects have newbie-friendly tasks, contributing guidelines, and active maintainers +If you are a new contributor, we have prepared a list of projects/components where you will get a warm welcome. +All these projects have tasks ready for new contributors, contributing guidelines, and active maintainers who have committed to assist contributors and to provide quick turnaround in pull requests. [frame="topbot",grid="all",options="header",cols="30%,15%,55%"] @@ -74,8 +68,7 @@ who have committed to assist contributors and to provide quick turnaround in pul | link:/[Jenkins Website] | Documentation, + Asciidoc, + - CSS, + - Ruby + CSS | Extend and improve Jenkins documentation, help to improve the website's look&feel, create link:/blog/[a new blogpost], a technology-specific solution page or a tutorial. link:https://github.com/jenkins-infra/jenkins.io/blob/master/CONTRIBUTING.adoc[Contributing guidelines], @@ -120,24 +113,6 @@ a| The plugin site is used to find information about 1800+ plugins available in link:https://github.com/jenkins-infra/jenkins.io/blob/master/CONTRIBUTING.adoc#adding-a-logo[Adding a logo] -| Jenkins Website - Docker-based Jenkins quickstart -| Documentation, Asciidoc, CSS, Ruby, Docker, Docker Compose, Bash -a| Extend Jenkins Documentation, help to provide examples, sample code, and documentation on how to start a local Jenkins controller. Improve existing link:/doc/book/installing/docker/[Jenkins Documentation] and other Documentation related to Docker (for example: link:/doc/tutorials/build-a-java-app-with-maven/[Build a Java app with Maven]), and provide easy-to-follow documentation, especially for those who are new to Jenkins. - - * Related Project: link:/projects/gsoc/2023/projects/docker-compose-build/#docker-based-jenkins-quickstart-examples[GSoC - Docker-based Jenkins quickstart examples] - * More information: link:/blog/2023/08/24/gsoc-docker-based-quickstart/[Blog - GSoC - Docker-based Jenkins quick start examples] - -| French translation -| Git, French, Jenkins developer tools -a| Improve coverage of French localization of the Jenkins web interface, including the Jenkins core and plugins. -The same is possible for other languages, let us know if you are interested! - - * Some proposal are listed in link:https://issues.jenkins.io/browse/JENKINS-66658[a dedicated Epic]. - * Use and improve if needed link:/doc/book/using/using-local-language/[the language selection documentation] - * Use and improve if needed link:/doc/developer/internationalization/[the internationalization documentation] - * If you want to participate to other language than French you are welcome ! However it would be great if you can find some other person speaking the target language for reviews. - * Add terms for controller/agent/.. (and previous naming) in a speaking language you are mastering in tables https://github.com/jenkinsci/jep/blob/master/jep/16/README.adoc#translations - | link:/projects/infrastructure/#pick-up-a-task[Jenkins Infrastructure] | Asciidoctor, Docker, Github Actions, Jenkins Pipeline, Kubernetes, Markdown, Packer, Puppet, Python, Shell, YAML a| An infrastructure is constantly moving forward: there are always dependencies to update, @@ -151,20 +126,29 @@ you are welcome to pick an issue and contribute! * Ready for action? Look at the good first issues we have on the infrastructure help desk at link:https://github.com/jenkins-infra/helpdesk/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22[good first issues] * You can also browse the link:https://github.com/jenkins-infra[`https://github.com/jenkins-infra`] GitHub organization and check for repositories and code. -| Content Security Policy (CSP) +| link:/doc/developer/security/csp/[Content Security Policy (CSP)] | JavaScript, Jelly, Security -a| During the last years, the Jenkins Security team has seen a lot of link:https://owasp.org/www-community/attacks/xss/[Cross-Site Scripting (XSS)] vulnerabilities, inside Jenkins core and also for a lot of plugins. -They have put in place different kinds of mechanisms to enhance the protection of some of the common dangerous code locations. +a| During the last years, the Jenkins Security team has seen a lot of link:https://owasp.org/www-community/attacks/xss/[Cross-Site Scripting (XSS)] vulnerabilities, inside Jenkins core and also for a lot of plugins. +They have put in place different kinds of mechanisms to enhance the protection of some of the common dangerous code locations. But this kind of approach does not scale enough to cover the wide ecosystem and the numerous different ways of introducing (accidentally) XSS vulnerabilities. -The objective of this topic is to ease the introduction of link:https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP[CSP] in Jenkins by un-inlining the JavaScript resources. +The objective of this topic is to ease the introduction of link:https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP[Content Security Policy (CSP)] in Jenkins by un-inlining the JavaScript resources. * Skill requirement: a bit of JavaScript. The Jelly part is straightforward. No need to have security background. * Time requirement: between 30 minutes and 4 hours. More details on the approach in link:https://docs.google.com/document/d/1hr_Kaf0fVWBACibpHbSYsk4RoqcHD3cBrqXxuTtWKVM[this document]. -link:https://issues.jenkins.io/issues/?jql=labels%20%3D%20newbie-friendly%20AND%20%22Epic%20Link%22%20%3D%20JENKINS-60865[Jira newcomer-friendly issues] +link:https://issues.jenkins.io/issues/?jql=labels%20%3D%20newbie-friendly%20and%20status%20not%20in%20(Resolved%2C%20closed%2C%20%22In%20Review%22%2C%20%22In%20Progress%22)%20and%20%20%22Epic%20Link%22%20%3D%20JENKINS-60865[Jira newcomer-friendly issues] + +| French translation +| Git, French, Jenkins developer tools +a| Improve coverage of French localization of the Jenkins web interface, including the Jenkins core and plugins. +The same is possible for other languages, let us know if you are interested! + + * Some proposals are listed in a link:https://issues.jenkins.io/browse/JENKINS-66660[dedicated Epic]. + * Use and improve the link:/doc/book/using/using-local-language/[language selection documentation] + * Use and improve the link:/doc/developer/internationalization/[internationalization documentation] |========================================================= @@ -200,6 +184,7 @@ See link:/events/hacktoberfest/faq[Hacktoberfest in Jenkins FAQ]. == Previous years +* link:/blog/2023/09/20/Hacktoberfest-2023/[2023] * link:/blog/2022/11/17/hacktoberfest-recap/[2022] * link:/blog/2021/10/31/hacktoberfest-results-2021/[2021] * link:/blog/2021/01/12/new-year-report/#jenkins-in-hacktoberfest-2020[2020] diff --git a/content/images/hacktoberfest/hacktoberfest_2024_logo.svg b/content/images/hacktoberfest/hacktoberfest_2024_logo.svg new file mode 100644 index 000000000000..1264d55bd7eb --- /dev/null +++ b/content/images/hacktoberfest/hacktoberfest_2024_logo.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/content/images/hacktoberfest/hacktoberfest_2024_social.jpg b/content/images/hacktoberfest/hacktoberfest_2024_social.jpg new file mode 100644 index 000000000000..2a1f744ff576 Binary files /dev/null and b/content/images/hacktoberfest/hacktoberfest_2024_social.jpg differ diff --git a/content/images/hacktoberfest/hacktoberfest_2024_social_600x300.png b/content/images/hacktoberfest/hacktoberfest_2024_social_600x300.png new file mode 100644 index 000000000000..e8916c76071a Binary files /dev/null and b/content/images/hacktoberfest/hacktoberfest_2024_social_600x300.png differ