# Contributing to the AlmaLinux project

# How to Contribute

Please, file your bugs (opens new window) and join us for discussions on GitHub (opens new window) and on AlmaLinux Chat on Mattermost (opens new window).

If you are interested in contributing, and learning more details about the technology stack of the tool and tests, please, visit the repository (opens new window).

Also, you might be interested with ELevate Project Contribution Guide.

# Contributing to Cloud Images

You can find more information about how these, and other cloud images are built on our Cloud Images GitHub Repository (opens new window). Join our Cloud SIG on Mattermost (opens new window) to help out with the effort or for support. You can also discuss on our Cloud SIG Forum (opens new window) and on our AlmaLinux Community Reddit (opens new window).

# Specific Areas We Need Help With

# 1. Volunteer Technical Community Coordinator for ELevate Project

We are looking for a volunteer Technical Community Coordinator to figure out what the community needs & wants from the AlmaLinux ELevate project. One of your primary responsibilities is to provide direction to the AlmaLinux OS engineers to help decide "what is next for the ELevate Project". As a Technical Community Coordinator, you'll engage with the community and schedule meetings with the AlmaLinux OS team.

Duties and Responsibilities

  • Coordinate community and AlmaLinux ELevate team
  • Consult and help users with ELevate Project
  • Check all possible bug sources (bugs.almalinux.org, forum, GitHub) and escalate to the ELevate team if the bug requires coding
  • Provide direction to the AlmaLinux ELevate team according to the feedback from the community and volunteers
  • Schedule meetings with the community and AlmaLinux ELevate team
  • Use social media to understand the community's needs

Requirements and Qualifications

  • Advanced English speaking and writing skills
  • Experience with AlmaLinux OS
  • Experience as a community planner or organizer
  • Management and organizational skills
  • High communication skills

If you are willing to help, email us at volunteer@almalinux.org.

# 2. Help with reporting bugs and making fixes

To make AlmaLinux successful, we need the close involvement of the community members. We use our bug tracking system to find, track, and fix bugs. We encourage AlmaLinux users to help us by filling in bug-reports. You can track and discuss all bugs on bugs.almalinux.org (opens new window).

# 3. Improve the documentation

It makes no sense to talk about the importance of documentation, it is like an investment in the future. It can take time and energy, but it is essential to create full and comprehensive documentation together.

If you want to participate, do the following:

  1. Fork the Wiki repository (opens new window).
  2. Edit or create a page.
  3. Commit your changes.
  4. Create a pull-request as described in the GitHub documentation (opens new window).

The Wiki is powered by VuePress (opens new window), so it's pretty easy to run it locally (run all commands from the project's root):

  1. Install necessary dependencies:
    $ yarn install
    
  2. Run a development web-server:
    $ yarn docs:dev
    
  3. Your local Wiki instance should be up and running on http://localhost:8080/ (opens new window).

# 4. Help with Azure mirrors deployment

We want to make sure that AlmaLinux images in Azure Cloud will use local mirrors for each region, and don't pay for traffic. More info here.

# 5. More ways to help for DevOps & Programmers

# Need assistance? We are here to help!

If you're seeking assistance in connecting with the appropriate individual or group, or if you're interested in guidance on becoming a contributor to AlmaLinux, please don't hesitate to reach out. You can contact our AlmaLinux Evangelist & PM, Pawel. He's available as pawel @ Mattermost chat (opens new window) or via email at PSUchanecki@almalinux.org.