# Contributing

Ensure that before contributing, you have basic knowledge of the git CLI tool as well as are semi-familiar GitHub.

An IDE or text editor is not needed due to the wiki being editable in the development build, but can be used if you want a wide overview of the code or just prefer coding in one in general.

You must also have the retypeapp package installed. Instructions are provided on Retype's Quick Start guide.

To begin helping out, you must first fork lunaui/bcit-resources on GitHub and create a remote instance of it on your machine. Leave the repository name the same as-is, unless you want to fork it for other purposes.

Navigate to that repository and take note of the URL, you will need it for the next section.

Clone the repository into a location of your choosing and then change directories to it. For demonstration purposes, I am going to be cloning the bcit-resources folder into the user's Documents folder.

Replace lunaui with your Github username, and usr with your machine's user's name.

cd C:\Users\usr\Documents
git clone https://github.com/lunaui/bcit-resources.git
cd bcit-resources

cd /home/usr/Documents
git clone https://github.com/lunaui/bcit-resources.git
cd bcit-resources

cd /Users/usr/Documents
git clone https://github.com/lunaui/bcit-resources.git
cd bcit-resources

To see a live preview of the page while the code is being edited, run the following command while still in the git directory:

retype start

A localhost server of the development build will be opened, allowing you to see changes in real time.

While serving the page this way, you can either directly edit the files with the edit button on the top right of any given article while in the development build, or you can edit the files with an IDE or text editor.

Both solutions are, at baseline, functionally identical.

In order to save the changes to this website and not just the copy you have on your machine, you will have to create and send a pull request.

To do this, first ensure all your changes have been pushed already.

git add .
git commit -m "{insert meaningful commit message}"
git push

Go to your repository on github. You should see a button above the file list called Contribute .

Create a pull request with a meaningful title and description describing what you have changed with your commits. After that, create the pull request with the corresponding button.

If your changes get approved (it probably will), you will see your changes on the website take effect!

TODO: cover discrepancies between BBY and DTC