Update 'CONTRIBUTING.md'

This commit is contained in:
Valentino Orlandi 2022-12-09 21:57:51 +00:00
parent d836158277
commit 239b9866db
1 changed files with 26 additions and 9 deletions

View File

@ -18,11 +18,34 @@ If you want to contribute to LogDoctor, please follow these steps:
- Possibly open an **Issue** before to start, to declare what your contribution will be
- **Fork** the `devel` branch of this project
- **Fork** the `devel` branch of this project ([How?](#how-to-fork-the-devel-branch), [Why?](#why-the-devel-branch))
- **Improve** it with your ideas
- Submit a **Pull Request** to the same branch (`devel`)
- Submit a **Pull Request** to the origin branch, namely `elB4RTO/LogDoctor:devel`
<br/>
## Pull Requests
When submitting a PR, please follow the template.
<br/><br/>
## How to fork the DEVEL branch
You have two ways of doing it:
- while forking:
- **uncheck** the "*Only copy the main branch*" option
*or*
- alternatively, you can do it afterwards:
- step in your fork of the repository
- select `branches` or click on `main` and select "*View all branches*"
- tap `New branch`
- insert the name you please and select `elB4RTO/LogDoctor` as repository and `devel` as branch
<br/>
@ -30,12 +53,6 @@ If you want to contribute to LogDoctor, please follow these steps:
It's related to the git system and mantainer's choice.<br/>
The `main` branch contains website-specific contents, which differ from site to site, while the `devel` branch is (supposed) to be the same and to act as an indipendent base for the code (and hopefully to keep a linear history).<br/>
As an example, if you push changes to the `main` branch on github, they won't appear as yours on gitlab (or whatever other site this repo is or will be hosted on) because the `devel` branch will never pull changes happened to `main`, so if you want your contribution to be part of the git repository indipendently from the platform, please follow the instructions.
<br/>
## Pull Requests
When submitting a PR, please leave a message with it explaining which has been your changes.
As an example, if you push changes to the `main` branch on github, they won't appear as yours on gitlab (or whatever other site this repo is or will be hosted on) because the `devel` branch will **never** pull changes happened to `main`, meaning that changes will have to be copy-pasted to the `devel` branch and re-committed.
<br/>