Skip to content

Commit

Permalink
Add Hacktoberfest 2024 blog post, update Hacktoberfest event docs (#7557
Browse files Browse the repository at this point in the history
)

* Add Hacktoberfest 2024 blog post and update event documentation

Images copied from the Hacktoberfest 2024 branding kit described at
https://hacktoberfest.com/events/#brand

https://hacktoberfest.com/_next/static/media/brand-kit.83c1dfe0.zip is
the download location for the branding kit.

* Add Hacktoberfest to the Jumbotron

Scrolling list of highlighted items
  • Loading branch information
MarkEWaite committed Sep 30, 2024
1 parent 6dbd76e commit dbd343a
Show file tree
Hide file tree
Showing 6 changed files with 108 additions and 47 deletions.
12 changes: 12 additions & 0 deletions content/_data/indexpage/carousel.yml
Original file line number Diff line number Diff line change
@@ -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
Expand Down
63 changes: 63 additions & 0 deletions content/blog/2024/09/2024-09-30-hacktoberfest.adoc
Original file line number Diff line number Diff line change
@@ -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"
79 changes: 32 additions & 47 deletions content/events/hacktoberfest.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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%"]
Expand All @@ -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],
Expand Down Expand Up @@ -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,
Expand All @@ -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]

|=========================================================

Expand Down Expand Up @@ -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]
Expand Down
Loading

0 comments on commit dbd343a

Please sign in to comment.