# Ansible Hacktoberfest Planning 2023

**URL:** <https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604>\
**Category:** Project Discussions\
**Tags:** community, hacktoberfest\
**Created:** [September 12, 2023, 6:13pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604 "2023-09-12T18:13:08Z")\
**Posts on this page:** 19\
**Page:** 1

<div class="post-metadata">

**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\
**Post date:** [September 12, 2023, 6:13pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/1 "2023-09-12T18:13:09Z")

</div>

# Hacktoberfest 2023 for Ansible Projects

This year, we’re opening up the following projects to participate in [Hacktoberfest 2023](https://hacktoberfest.com/)

- [ansible/ansible-documentation](https://github.com/ansible/ansible-documentation/issues?q=is%3Aopen+is%3Aissue+label%3Ahacktoberfest)
- [ansible/awx](https://github.com/ansible/awx/issues?q=is%3Aopen+is%3Aissue+label%3AHacktoberfest)

## Participating projects

See the [maintainers guidelines](https://hacktoberfest.com/participation/#maintainers) for how to set up issues and your repo to be part of Hacktoberfest.

While there can be some spam from Hacktoberfest participants, we’ve run this on Ansible core/package docs for the past three years, and it’s a great way to get new contributors to create PRs for simple things. Most Hacktoberfest participants come in the first week or so of October, so that is when you’ll want to be available to review and merge appropriate PRs.

## General project owner guidelines

To run a successful Hacktoberfest:

- Review where you have easy/simple fixes or code cleanup efforts that a contributor can help with without needing to be an expert at your project.

- Create a batch of issues for these simple fixes - Multiple smaller issues are better than one big issue.

- For docs, it’s useful to group similar fixes as one issue per guide, to reduce merge conflicts.

- Label these issues with the `hacktoberfest` tag. We can then create a cross-project filter to publicize the list of participating Hacktoberfest issues in the Bullhorn and Forum.

- Be ready on Oct 1 - the PRs can come in quickly. Most will be good, some will be spam. The main rush is usually over by mid-month.

- If the fix is reasonable, consider merging it. It may not be the perfect fix, but Hacktoberfest is a way to encourage open source contributions, so relax requirements if you can (easier to do in docs than in code).

## Brainstorming ideas

Possible ideas for docs (could be applied to any Ansible project):

- [https://github.com/ansible/ansible-documentation/pull/386](https://github.com/ansible/ansible-documentation/pull/386) - Open a separate issue for each term (for larger projects) where contributors can search/replace terms to match the Ansible style guide list of terms
- Run something like codspell on each docs directory and fix the spelling errors.
- Bring docs in alignment with other areas in the [Ansible Style Guide](https://docs.ansible.com/ansible/latest/dev_guide/style_guide/index.html).

---

<div class="post-metadata">

**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\
**Post date:** [September 12, 2023, 6:14pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/2 "2023-09-12T18:14:26Z")

</div>

I changed this to a wiki format, so we can modify etc. as we go along. The goal is to put enough guidelines here so that any Ansible ecosystem project can participate (with docs or code simple fix issues).

---

<div class="post-metadata">

**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\
**Post date:** [September 19, 2023, 6:47pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/3 "2023-09-19T18:47:21Z")

</div>



---

<div class="post-metadata">

**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\
**Post date:** [September 19, 2023, 6:49pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/4 "2023-09-19T18:49:38Z")

</div>

Once we have a list of participating projects and issues opened, we can put this in the Bullhorn to show up in the month of October.

---

<div class="post-metadata">

**Author:** ![gwmngilfen](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gwmngilfen/32/6_2.png) [@gwmngilfen](https://forum.ansible.com/u/gwmngilfen)\
**Post date:** [September 19, 2023, 7:19pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/5 "2023-09-19T19:19:45Z")

</div>

This is great, thanks @samccann! I was also wondering about some kind of tracker, perhaps embedded here. Assuming I can work up some tech for it, how would it feel to have a “hacktoberfest bar” somewhere? And should it be per-repo, or total (I prefer total, I think)?

---

<div class="post-metadata">

**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\
**Post date:** [September 19, 2023, 7:49pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/6 "2023-09-19T19:49:48Z")

</div>

oh a tracker would be fun yeah! I’d say total, not per repo…

---

<div class="post-metadata">

**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\
**Post date:** [September 28, 2023, 6:03pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/7 "2023-09-28T18:03:20Z")

</div>

This is the list of hacktoberfest issues across the Ansible projects:  
[https://github.com/search?q=user%3Aansible+user%3Aansible-community+label%3Ahacktoberfest+state%3Aopen&type=issues](https://github.com/search?q=user%3Aansible+user%3Aansible-community+label%3Ahacktoberfest+state%3Aopen&type=issues)

---

<div class="post-metadata">

**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\
**Post date:** [September 28, 2023, 6:03pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/8 "2023-09-28T18:03:48Z")

</div>

We should make this more prominent on Monday…

---

<div class="post-metadata">

**Author:** ![Leo](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/leo/32/23_2.png) [@Leo](https://forum.ansible.com/u/Leo)\
**Post date:** [September 29, 2023, 2:06pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/9 "2023-09-29T14:06:26Z")

</div>

Ansible Middleware team is joining and shared the following to the Matrix Social channel:

> This October, [Ansible Middleware](https://github.com/ansible-middleware) is participating in the [Hacktoberfest 2023](https://hacktoberfest.com/), the global celebration of open source collaboration.
> 
> **Ansible Middleware** is a suite of supported content that combines the power of Ansible automation with Red Hat’s Middleware portfolio. It allows organizations to meet their business demands and automate the installation, configuration, and management of Enterprise Middleware.
> 
> **Ready to contribute?** Check out the [Contributing Guide](https://github.com/ansible-middleware/keycloak/blob/main/CONTRIBUTING.md), and browse [Hacktoberfest Issues  
> ](https://github.com/search?q=org%3Aansible-middleware+state%3Aopen+label%3Ahacktoberfest&type=issues)
> 
> **Questions?** Reach out via email, if you have any queries or need assistance.

I mentioned to Ranabir Chakraborty in the channel this planning thread and asked if they could use the forum as reach out instead of the email. I will try to ping the Middleware team and see if they can get on-board.

By the way: the Middleware content is not only for the RH products, but also for the upstream projects, that might be useful to highlight as well.

---

<div class="post-metadata">

**Author:** ![RanabirChakraborty](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/ranabirchakraborty/32/887_2.png) [@RanabirChakraborty](https://forum.ansible.com/u/RanabirChakraborty)\
**Post date:** [September 29, 2023, 2:25pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/10 "2023-09-29T14:25:01Z")

</div>

Thank you so much, Leo for onboarding us. I’m very new to the Ansible community forum, and not sure how to promote our Ansible Middleware projects for the upcoming Hacktoberfest. Let us know we are always happy to help and contribute.🙂

---

<div class="post-metadata">

**Author:** ![Leo](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/leo/32/23_2.png) [@Leo](https://forum.ansible.com/u/Leo)\
**Post date:** [September 29, 2023, 3:42pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/11 "2023-09-29T15:42:50Z")

</div>

Welcome to the forum @RanabirChakraborty! Glad to see you here and what you did by posting to the Bullhorn was a great way to promote it.

We will be going over the planning on Monday here as well (@samccann is leading that), and we will update the parent post as a go-to topic as well as share suggestions and details.

You can check the #hacktoberfest tag and follow it for notifications if you want as well (click the tag, and use the bell at the top right in the tag page).

You are welcome to post an intro into the Middleware project in the #Project Discussions category (so we can add the #middleware tag) and if the rest of the Middleware team can join the forum, we can create a group for you as well.

---

<div class="post-metadata">

**Author:** ![Leo](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/leo/32/23_2.png) [@Leo](https://forum.ansible.com/u/Leo)\
**Post date:** [September 29, 2023, 6:49pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/12 "2023-09-29T18:49:16Z")

</div>

@samccann list of possible blog posts to participate in #hacktoberfest and discuss on Monday:

1. [New Ansible Galaxy](https://www.ansible.com/blog/new-ansible-galaxy)
2. [Event-Driven Ansible is Here](https://www.ansible.com/blog/event-driven-ansible-is-here)
3. [Getting Started with Event-Driven Ansible](https://www.ansible.com/blog/getting-started-with-event-driven-ansible)
4. [Event-Driven Ansible - ChatOps - From Chat to Action](https://www.ansible.com/blog/event-driven-ansible-chatops-from-chat-to-action)
5. [Kubernetes Meets Event-Driven Ansible](https://www.ansible.com/blog/kubernetes-meets-event-driven-ansible)
6. [Ansible and ChatGPT: Putting it to the test](https://www.ansible.com/blog/ansible-wisdom-and-chatgpt-putting-it-to-the-test)
7. [Deep dive on Ansible VScode extension](https://www.ansible.com/blog/deep-dive-on-ansible-vscode-extension)
8. [Automating Azure Infrastructure for High Availability Web Hosting with Ansible](https://www.ansible.com/blog/automating-azure-infrastructure-for-high-availability-web-hosting-with-ansible)
9. [Ansible data manipulation with a Filter](https://www.ansible.com/blog/ansible-data-manipulation-with-a-filter)
10. [How to use the new Constructed Inventory Feature in Ansible Automation Platform 2.4](https://www.ansible.com/blog/how-to-use-the-new-constructed-inventory-feature-in-aap-2.4)

The following ones have updated versions and would be good to have them at the same time, with a banner showing an “update note” for the older post pointing to the new one:

1. [Introduction to Ansible Builder](https://www.ansible.com/blog/introduction-to-ansible-builder)
  - [Unlocking efficiency: Harnessing the capabilities of ansible-builder 3.0](https://www.ansible.com/blog/unlocking-efficiency-harnessing-the-capabilities-of-ansible-builder-3.0)

2. [Developing and Testing Ansible Roles with Molecule and Podman - Part 1](https://www.ansible.com/blog/developing-and-testing-ansible-roles-with-molecule-and-podman-part-1)
  - The updated one is currently in [developers.redhat.com](http://developers.redhat.com), an upstream one is coming later, for now the updated banner should point to for molecule 6: [Introducing Ansible Molecule with Ansible Automation Platform | Red Hat Developer](https://developers.redhat.com/articles/2023/09/13/introducing-ansible-molecule-ansible-automation-platform)

We might want to add others I’m leaving out for now, we can review that as well.

---

<div class="post-metadata">

**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\
**Post date:** [October 2, 2023, 7:57pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/13 "2023-10-02T19:57:10Z")

</div>

Thanks Leo! We’ll work to get this out as issues so folks can help out here as well.

---

<div class="post-metadata">

**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\
**Post date:** [October 2, 2023, 7:57pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/14 "2023-10-02T19:57:39Z")

</div>

AWX docs are also adding a bunch of hacktoberfest issues!

> **[Issues · ansible/awx](https://github.com/ansible/awx/issues?q=is%3Aopen%2Bis%3Aissue%2Blabel%3AHacktoberfest)**
>
> AWX provides a web-based user interface, REST API, and task engine built on top of Ansible. It is one of the upstream projects for Red Hat Ansible Automation Platform. - Issues · ansible/awx

---

<div class="post-metadata">

**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\
**Post date:** [November 17, 2023, 9:09pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/15 "2023-11-17T21:09:24Z")

</div>

Final summary - we closed 33 issues across the ansible-documentation and awx docs repos. Thanks to everyone who participated this year!

---

<div class="post-metadata">

**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\
**Post date:** [November 20, 2023, 9:38pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/16 "2023-11-20T21:38:38Z")

</div>

@Leo - I opened issues for the remaining 9 blog posts above (in your first section) - [Issues · ansible-community/community-website · GitHub](https://github.com/ansible-community/community-website/issues?q=is%3Aopen+label%3Ablog+author%3Asamccann)

Can you take a quick look at the metadata to make sure of the values? I made up the categories/tags so… might need adjustment.

@Dule-martins will be using these issues to help train a new group of contributors so want to be sure the details are correct.

---

<div class="post-metadata">

**Author:** ![Dule-martins](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/dule-martins/32/523_2.png) [@Dule-martins](https://forum.ansible.com/u/Dule-martins)\
**Post date:** [November 23, 2023, 6:19pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/17 "2023-11-23T18:19:55Z")

</div>

Hello @samccann I am ready to start organizing this issue by adding them to the board.

---

<div class="post-metadata">

**Author:** ![Dule-martins](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/dule-martins/32/523_2.png) [@Dule-martins](https://forum.ansible.com/u/Dule-martins)\
**Post date:** [November 23, 2023, 8:42pm UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/18 "2023-11-23T20:42:37Z")

</div>

I can see that you have added some issues to the board thank you very much, would still love to add more.

---

<div class="post-metadata">

**Author:** ![Leo](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/leo/32/23_2.png) [@Leo](https://forum.ansible.com/u/Leo)\
**Post date:** [November 24, 2023, 4:28am UTC](https://forum.ansible.com/t/ansible-hacktoberfest-planning-2023/604/19 "2023-11-24T04:28:34Z")

</div>

> [@samccann](#):
>
> Can you take a quick look at the metadata to make sure of the values? I made up the categories/tags so… might need adjustment.

Hi @samccann , done! did a check and added a comment to each on the suggested changes. Thanks for pinging me!
