<p align="center">
  <img src="apine-logo-telegram-groups.jpg" alt="Alpine Linux" width="350" />
</p>

---

title: Contributing

---


# Contributing to Alpine Wiki

.. a markdown based effor to provide non-minimalist documentation 
for a minimalist operating system named [Alpine Linux](alpine/about.md)

All contributors are expected to abide by our [Rules of Conduct](rules-of-conduct.md) and our [Copyright and Policy](copyright.md)

#### Contributing Guidelines

Thanks for your interest in contributing to the project! Those are the 
**areas or ways you can contribute**:

- Help to improve and redact into the wiki:
    - [How to join and fill a suggestion](#how-to-join-and-fill-a-suggestion)
    - [How to join and improve articles](#how-to-join-and-improve-articles)
- Help to define and manage into the wiki:
    - [How to join and apply for bug issue handler](#how-to-join-and-apply-for-bug-issue-handler)
    - [How to join and apply for repo sync manager](#how-to-join-and-apply-for-repo-sync-manager)

Each of ***those areas or ways have already alternative ways to do the same**, 
cos obviously will need minimal requirements already explained in each section.

## How to join and fill a suggestion

#### Requeriments

- Have a codeberg account

#### Procedure

1. Join at codeberg by sing in an account or login
2. Go to the issue tab on the repository
3. Create a [new issue here](https://codeberg.org/alpine/alpine-wiki/issues/new) using the green button at the almost top right corner
4. Fill your suggestion [Following the formats]
5. Take care of the description, justify the changes
7. Wait for aproval and stay alert about any comment

#### Alternatives

You can send us the sugestion by using our social networks, but will be not officially followed:

- 🗯 IRC
  - 💬 `##alpine_telegram_english`
  - 💬 `#alpine_linux_english`
- 📱 Telegram https://t.me/alpine_linux
  - 🇬🇧 https://t.me/alpine_linux_english
  - 🇷🇺 https://t.me/alpine_linux_pycckuu (dual english russian, low activity)
  - 🇨🇴 https://t.me/alpine_linux_espanol
  - 🇧🇬 https://t.me/alpine_linux_bulgarian (dual english bulgarian, low activity)
  - 🇨🇳 https://t.me/alpine_linux_chinese (dual english chinese, low activity)
- Matrix
  - 👥 https://matrix.to/#/#alpine-linux-english:matrix.org

## How to join and improve articles

#### Requeriments

- Have a codeberg account
- Have knowledge of [git and git workflow]
- Have knowledge of [Markdown sintax] and our [Format of wiki edits]

#### Procedure

1. Join at codeberg by [sing in] an account or [login]
2. Fork the repository into your own userspace
3. Create a branch from the base one
4. Make your edits using our [Format of wiki edits]
5. Send a Merge Request or Pull Request to our repo
6. Take care of the description, justify the changes
7. Wait for aproval and stay alert about any comment

#####  Alternatives

Sending us the entire changed file is our of sync with guidelines 
so an alternative way for that its using the [How to join and fill a suggestion](#how-to-join-and-fill-a-suggestion) 
case.

## How to join and apply for bug issue handler

#### Requeriments

- Have a codeberg account
- Have knowledge of [git and git workflow]
- Already made some amopunt of contributions to the alpine wiki

#### Procedure

#### Alternatives

TODO

## How to join and apply for repo sync manager

#### Requeriments

- Have an codeberg account
- Have an IRC and Telegram account and be on our channel and groups
- Have knowledge of [git and git workflow]
- Have knowledge of [linux filesystem]
- Already made some amount of contributions to the alpine wiki

#### Procedure

1. Join at codeberg by [sing in] an account or [login]
2. TODO

#### Alternatives

TODO

# Check also

* [about.md](about.md)
* [copyright.md](copyright.md)
* [README (index)](README.md)
* [README (main)](../README.md)