Dojo Content - Working Locally

by geekdojo


No files for this article.

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.

Software Installs

The software installs below will greatly accelerate your editing process with the Dojo.

1. Sign-up for GitHub

Create an account

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

If not already done so, please install Git CLI or Github Desktop.

Note: If you have never used Git it is highly recommended that you complete the beginner tutorials. The manual for Git is also available online.

Working Locally

1. Fork geekdojo-com

  1. In the GiHub user interface navigate to the geekdojo-com repository.
  2. At the top right corner click Fork.
  3. 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.
  4. 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:

  1. Type and execute (by pressing Enter)

    mkdir c:\src
  2. Change to the new directory:

    cd c:\src
  3. Clone the Fork locally:

    git clone <paste the URL from 1.4>

3. Open and Edit in VSCode

  1. Now, open VSCode and click Open Folder.
  2. Navigate to and Open the src/geekdojo-com directory.
  3. Proceed to edit the content as needed.

4. Commit and Push Local Changes

  1. In VSCode, select Terminal from the Menu and click New Terminal.

  2. In the terminal window type and enter:

    git add --all
  3. 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.

  4. Finally:

    git push

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.