Skip to content

Commit

Permalink
docs: update CONTRIBUTING.md
Browse files Browse the repository at this point in the history
  • Loading branch information
musicEnfanthen authored Feb 13, 2025
1 parent 0d65cd9 commit c1a70f5
Showing 1 changed file with 14 additions and 1 deletion.
15 changes: 14 additions & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ To install and run Jekyll natively on your machine, please follow these steps:

#### Step 3b: Run Jekyll in a Docker container

To avoid installing Jekyll natively and to assure it comes with all the necessary dependencies, you can run it in a preconfigured container image. The publishers of Jekyll offer a corresponding Docker image for such purposes. To run it, please follow these instructions:
To avoid installing Jekyll natively and to assure it comes with all the necessary dependencies, you can run it in a preconfigured container image. The publishers of Jekyll offer a corresponding [Docker image](https://github.com/envygeeks/jekyll-docker) for such purposes. To run it, please follow these instructions:

1. Install Docker

Expand All @@ -85,6 +85,19 @@ To avoid installing Jekyll natively and to assure it comes with all the necessar

This will compile the site and start serving the content locally. Information on the compilation process will be output to the command shell. Once it's ready, you can open your browser and visit `http://localhost:4000` to see your local version of the website.
> [!NOTE]
> The `$PWD` ("print working directory") command is commonly used in Unix-like operating systems to get the current working directory.
> However, on other systems, especially Windows, you might need to replace it with a different command. Below are the alternatives for different command line tools:
>
> | Command Line Tool | Command |
> |-------------------|---------|
> | **Unix-like Systems** | |
> | - Terminal | `$PWD` |
> | **Windows Systems** | |
> | - Powershell | `${PWD}` |
> | - CMD | `%CD%` |
> | - Git Bash for Windows | `/$(pwd)` |
### Step 5. Make your changes and commit
You should now be able to make your changes. Try to keep your commits as ‘atomic’ as possible; that is, commit only the changes necessary for a given set of functionality. Avoid large commits that change a lot of things, as this makes it harder to review your changes for unintended side effects and potential problems.
Expand Down

0 comments on commit c1a70f5

Please sign in to comment.