2019-02-11 15:19:08 +01:00
# Contributing
Hey, welcome to the party! 🎉
2019-02-11 17:13:12 +01:00
Thank you so much for contributing to EasyMDE. 😘
2019-02-11 15:19:08 +01:00
## Asking questions, suggesting wonderful ideas or reporting bugs
You can [submit an issue️ ](https://github.com/Ionaru/easy-markdown-editor/issues/new ) on this GitHub repository.
## Coding
2019-02-11 17:13:12 +01:00
### 📦 Prerequisites
2019-02-11 15:19:08 +01:00
2019-02-21 17:48:55 +01:00
You need Node.js and npm.
2019-02-11 15:19:08 +01:00
To install them on Debian-based systems:
```bash
2019-02-13 11:57:44 +01:00
curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
2019-02-11 15:19:08 +01:00
sudo apt-get install -y nodejs
echo -e "nodejs version:\t$(nodejs -v) \nnpm version:\t$(npm -v)"
# check that you have node.js and npm.
```
For other systems, please [read the official page ](https://nodejs.org/en/download/ ).
### 🏗️ Installation
Here we go! 🤠 First, clone this repository:
```bash
git clone https://github.com/Ionaru/easy-markdown-editor.git
2019-02-12 13:42:01 +01:00
cd easy-markdown-editor
2019-02-11 15:19:08 +01:00
```
2019-02-21 17:48:55 +01:00
Then install the required dependencies:
2019-02-11 15:19:08 +01:00
```bash
2019-02-11 17:13:12 +01:00
npm install
2019-02-11 15:19:08 +01:00
```
Yay! You are ready! 🍾
2019-02-12 13:42:01 +01:00
2019-02-11 15:19:08 +01:00
### ⤴️ Creating a pull request
2019-02-11 15:24:55 +01:00
1. First, [create a fork of this project ](https://github.com/Ionaru/easy-markdown-editor/fork ), and copy the https URL (*clone or download* button) of your project (something like https://github.com/YOUR_USERNAME/easy-markdown-editor.git );
2019-02-13 09:40:47 +01:00
2. a) If you already cloned and worked on the project: `git remote add source https://github.com/Ionaru/easy-markdown-editor.git` ;
2019-02-21 17:48:55 +01:00
b) Otherwise, clone your fork: `git clone https://github.com/YOUR_USERNAME/easy-markdown-editor.git` ;
3. Create a new dedicated branch `git checkout -b myMergeRequest` ;
2019-03-07 13:42:09 +01:00
4. Write some nice code and commit your work. (Don't forget to add your changes to the changelog!);
2019-02-21 17:48:55 +01:00
5. Check files against the ESLint syntax and build minified versions: `gulp` ;
2019-03-07 13:42:09 +01:00
6. Test your changes;
7. Push it to a dedicated branch `git push origin myMergeRequest` ;
8. Go to the [main project page ](https://github.com/Ionaru/easy-markdown-editor ) and click on the button *Compare and pull request* , then fill the description.
2019-02-11 15:19:08 +01:00
2019-02-12 13:42:01 +01:00
If you want to make other pull requests, go back to the master branch (`git checkout master` ), update it (`git pull --rebase source master` ), then follow the instructions above from step 3.
2019-02-11 15:19:08 +01:00
Thank you! 💜