Skip to content

Latest commit

 

History

History
132 lines (81 loc) · 5.94 KB

CONTRIBUTING.md

File metadata and controls

132 lines (81 loc) · 5.94 KB

Contributing to Wikisyllabus

Thank you for investing your time in contributing to our project✨

If you don't have Git Bash on your machine, install it.

If you are new to Git and Github, you need to create a Github Account. It is advisable that you go through Git Handbook before moving to next step.

Fork the repository

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

Clone the repository

Now clone the forked repository to your machine. Go to your GitHub account, open the forked repository, click on the code button and then click the copy to clipboard icon.

Open Git Bash and run the following git command:

git clone url

where url is the url you just copied! (your fork of this project).
For example:

git clone https://github.com/username/Wikisyllabus.git

where username is your GitHub username. Here you're copying the contents of the Wikisyllabus repository on GitHub to your computer.

Create an issue

What's an issue?

To create an issue, On the main page of your repository, click Issues. Click New issue.
Click Get started next to the type of issue you'd like to open. Or, click Open a blank issue if the type of issue you'd like to open isn't included in the available options.
Type a title and description for your issue. Then click Submit new issue.

Make necessary changes

Open up the project in your favourite text editor, select the file you want to contribute to, and make your changes.Make sure to save the edits.

All the files in this project are .md files. You would need to have Markdown knowledge to contribute to this project.

Markdown is a fast and easy way to take notes, create content for a website, and produce print-ready documents. It doesn't take long to learn the Markdown syntax, and once you know how to use it, you can write using Markdown just about everywhere. Visit here to master Markdown.

You could add Notes, Useful Website links, Youtube lecture links or anything you find useful in learning the specific topic.

Add and Commit your changes

Open Git Bash, navigate to the project directory and execute the command git status, you'll see there are changes. Add those changes to the branch you just created using the git add command:

git add filename.md

You can also add all the unstaged files using : git add .

Now commit those changes using the git commit command:

git commit -m "commit message"

Push changes to GitHub

Push your changes using the command git push:

git push origin main

Create a pull request

Open the main page of your repository on your GitHub account in your browser and click on the Pull requests tab. Now, click on the New Pull Request button. Click Create Pull Request option. Enter a suitable title and description for the pull request. Now submit the pull request.

What is a pull request?

You can find more GitHub Commands here

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

To Add your details in contributors

Comment on Issue or Pull Request, asking @all-contributors to add your details.

@all-contributors please add @<username> for <contributions>

eg:

@all-contributors please add @userid for coding

Make sure to add this comment after merging one of your PR to main

Setting Up mdBook (Optional)

mdBook is a command line tool and Rust crate to create books with Markdown. You can edit the markdown files (.md) in a text editor of your choice, but you wouldn’t be able to view the rendered output in the book form with formatting. To view the book as intended, you will need to set up the mdBook CLI on your system.

mdBook can be installed with cargo, the package manager for Rust extensions. Cargo installation procedure is different depending on the OS you’re running.

Linux/MacOS

  • Install rustup and cargo by running this command in the terminal. (Note : You may need to reopen the terminal after this command executes.)
    curl https://sh.rustup.rs -sSf | sh

  • Install the mdBook CLI from cargo
    cargo install mdbook

  • Check version of mdBook installed to verify the installation was successful cargo -V

Windows

  • Install rustup and cargo

  • To use cargo, you may need to have C/C++ Build tools. If you don’t have it installed, there are two options, choose either one.

    • GNU C Compiler : Install it using the following commands rustup toolchain install stable-x86_64-pc-windows-gnu rustup default stable-x86_64-pc-windows-gnu
    • Visual Studio C++ Build Tools : Install C++ build tools from this link
  • Install the mdBook CLI from cargo : cargo install mdbook

  • Check version of mdBook installed to verify the installation was successful : cargo -V

You could go through mdBook Handbook to get more familiar with mdBook.

Context from : https://github.com/gtechatfg/WikiSyllabus/blob/main/CONTRIBUTING.md