Skip to content

Latest commit

 

History

History
79 lines (45 loc) · 3.44 KB

CONTRIBUTING.md

File metadata and controls

79 lines (45 loc) · 3.44 KB

Contributor's Guide

Please ensure you have GitHub Desktop installed and have logged into your GitHub account!

The following steps explain how to add a plugin to the repo but themes follow the same structure!

Fork this repository

Fork this repo by clicking on the fork button on the top right of this page. This will create of copy of this repository in your account.

fork this repository

Clone the repository

Now clone this repo to your machine.

IMPORTANT: DO NOT CLONE THE ORIGINAL REPO. Go to your fork and clone it.

To clone the repo, click on "Clone or Download" and then click on "Open in Desktop".

fork this repository

A pop up window will open. Click on "Open GitHubDesktop.exe".

fork this repository

After you click on "Open GitHubDesktop.exe" the contents will be downloaded to your computer.

fork this repository

Create a branch

Now create a branch by clicking on the "Current branch" icon at the top and then click on "New branch":

fork this repository

Name your branch. For example, "LachlanDev"

Click on Create branch

Make necessary changes and commit those changes

Click on the Repository icon at the top and then click on "Open in Visual Studio Code"

Once opened you want to expand the "Plugins" Folder and create a new folder with your name example, "LachlanDev"

fork this repository

Inside the newly created folder you must follow this structure, if ignored your pull request will be ignored. Also check out my folder as an example.

│   LachlanDev - Name of folder (Developer)
│   ├── README.md - Your README file, used to induce yourself or list your plugins
│   └── PluginFolder - Each plugin will be in a seperate folder
│       ├── README.md - Plugin README with documentation etc..
│       └── Plugin Source Code

Once completed it should look something like this, if you have further questions or need help feel free to ask me!

Please ensure you mention packages your plugin requires in the plugins README.md

fork this repository

Head back to GitHub Desktop and click on the "Commit" button in bottom left, you will need to input a summary.

fork this repository

Finally Click the Publish button on the top right.

Submit your changes for review

If you go to your repository on github, you'll see Compare & pull request button. click on that button.

You will be redirected to a new page, add a title and leave a comment explaing the commands you have added.

Soon I'll be merging all your changes into the master branch of this project. You will get a notification email once the changes have been merged.

What's next?

Congrats! You just completed the standard fork -> clone -> edit -> PR workflow that you'll encounter often as a contributor!

You must follow the folder structure or your pull request will not be accepted, need assistance join the Discord Server or message me on Discord LachlanDev#8014