From 3f5bb6f310bf46cb7ff6f24897ad0919191902b4 Mon Sep 17 00:00:00 2001 From: Marty <149421156+ffe9f8@users.noreply.github.com> Date: Fri, 20 Sep 2024 17:20:43 +0200 Subject: [PATCH] fix: contributing guidelines formatting (#1159) --- CONTRIBUTING.md | 40 +++++++++++++++++++--------------------- 1 file changed, 19 insertions(+), 21 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index f2ee9dbf..2be107a3 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,19 +1,17 @@ -## Contributing to Axelar +# Contributing to Axelar We appreciate your interest in contributing to Axelar! This document `CONTRIBUTING.md` provides a high-level overview of how you can get involved. -### Table of Contents +## Table of contents -- [Contributing to Axelar](#contributing-to-axelar) - - [Table of Contents](#table-of-contents) - - [Getting Started](#getting-started) - - [How to Contribute](#how-to-contribute) +- [Getting Started](#getting-started) +- [How to contribute](#how-to-contribute) - [Code of Conduct](#code-of-conduct) - - [Our Standards:](#our-standards) - - [Our Responsibilities:](#our-responsibilities) - - [Project Structure](#project-structure) + - [Standards](#our-standards) + - [Responsibilities](#our-responsibilities) +- [Project structure](#project-structure) -### Getting Started +## Getting started If you are new to the Axelar Network, we encourage you to read the [Axelar Documentation](https://docs.axelar.network/) to learn more about the Axelar Network and how to get started. @@ -21,25 +19,25 @@ If you are new to contributing to open-source projects, we encourage you to read --- -### How to Contribute +## How to contribute 1. Before you submit your Pull Request (PR), search the project for an open or closed PR related to your submission. You don't want to duplicate effort. 2. Fork the repository within your user and clone it to your local machine. -3. Install the dependencies for the project as indicated in the README.md +3. Install the dependencies for the project as indicated in the README. 4. Create a new branch for your contribution with the following command: ```shell git checkout -b my-fix-branch ``` -5. Make your changes in the new git branch +5. Make your changes in the new git branch. 6. Commit your changes. Your commit message should follow the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) specification. ```shell git commit -a ``` - Note: the optional commit `-a` command line option will automatically "add" and "rm" edited files. Push your branch to GitHub with the following command: + **Note:** the optional commit `-a` command line option will automatically "add" and "rm" edited files. Push your branch to GitHub with the following command: ```shell git push origin my-fix-branch @@ -47,22 +45,22 @@ If you are new to contributing to open-source projects, we encourage you to read Open a pull request from your forked repository to the original repository. -If we suggest changes then: +If we suggest changes: - Make the required updates and commit them to your branch. -- Wait for the project maintainer to review your changes and merge your Pull Request. +- Wait for the project maintainer to review your changes and merge your pull request. > If you find a bug in the source code or a mistake in the documentation, you can help us by submitting an issue. -When you open a new issue, please provide as much detail as possible, including steps to reproduce the problem and the expected behavior. Even better, you can submit a Pull Request with a fix. +When you open a new issue, please provide as much detail as possible, including steps to reproduce the problem and the expected behavior. Even better, you can submit a pull request with a fix. --- -### Code of Conduct +## Code of conduct We pledge to create a harassment-free experience for everyone in our project and community, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation. -#### Our Standards: +### Standards We expect all participants to use welcoming and inclusive language, respect differing viewpoints and experiences, gracefully accept constructive criticism, focus on what's best for the community, and show empathy towards other members. @@ -74,13 +72,13 @@ Unacceptable behavior includes: - Publishing others' confidential information without explicit permission. - Any other conduct that could be considered inappropriate in a professional setting. -#### Our Responsibilities: +### Responsibilities As project maintainers, we clarify the standards of acceptable behavior and take appropriate corrective action in response to unacceptable behavior. We also reserve the right to remove or reject any contributions that do not align with this Code of Conduct or to temporarily or permanently ban any contributor who exhibits inappropriate, threatening, offensive, or harmful behavior. -### Project Structure +## Project structure - **`src/content/`**: All documentation content in Markdown format. - **`src/layouts/navigation.ts`**: Defines the navigation structure for the documentation site.