For small, grammar or spelling level corrections the easiest process to contribute the change directly on the GitHub repository. However, for larger changes involving multiple content, hub, or landing pages, working locally can provide a substantial productivity boost. This guide will walk you through how to setup your local workstation to support contributing content back to the Dojo.
The software installs below will greatly accelerate your editing process with the Dojo.
1. Sign-up for GitHub
Create an account Github.com
2. Install Visual Studio Code
Install the latest version of Visual Studio Code (VSCode).
3. Install the Doc Authoring Pack Extension
Install Microsoft's Doc Authoring Pack via the Extensions menu.
4. Install Git
1. Fork geekdojo-com
- In the GiHub user interface navigate to the geekdojo-com repository.
- At the top right corner click Fork.
- In the light window that pops up select your username. Doing so will create a copy under your user in GitHub. GitHub should redirect you to the newly created repository once it completes the Fork.
- In the new Fork click the Clone or download button and copy the HTTPS URL out of the pop-up window. You will use this URL in the next step.
2. Clone Locally
In a Command (Windows) or Terminal (Mac) window, do the following:
Type and execute (by pressing Enter)
Change to the new directory:
Clone the Fork locally:
git clone <paste the URL from 1.4>
3. Open and Edit in VSCode
- Now, open VSCode and click Open Folder.
- Navigate to and Open the src/geekdojo-com directory.
- Proceed to edit the content as needed.
4. Commit and Push Local Changes
In VSCode, select Terminal from the Menu and click New Terminal.
In the terminal window type and enter:
git add --all
Then enter the following:
git commit -s -m "<enter an appropriate message documenting the change>"
Note: you must have the "-s" option to sign-off on your commit. You can read about signing off on opensource commits in Github Docs.
5. Submit a Pull Request
Navigate back to the geekdojo-com repository in GitHub and issue a Pull Request using the fork under your user account as the merge base.
- Pull Request guide from GitHub.