Green Web Foundation - Developer Docs Website

Welcome to the developer documentation site for Green Web Foundation's open-source libraries. Here, you'll find comprehensive guides and resources to help you understand, use, and contribute to our projects effectively.

Getting Started

To work on this site locally, follow these steps:

Prerequisites

Before you begin, make sure you have the following software installed on your machine:

• Node.js v20 or later
• npm or yarn

This project is built using the Eleventy (11ty) static site generator. The 11ty documentation has thorough explainers for different bits of functionality that might come in useful when working on this website.

This project's template files are written in Nunjucks and Markdown. If you are using Visual Studio Code as your code editor when working on this project, we recommend that you install the following plugins:

• Nunjucks for Visual Studio Code
• markdownlint

Installation

1. Clone repository: Start by cloning this repository to your local machine using Git:

   git clone https://github.com/thegreenwebfoundation/developer-docs

   If you plan to contribute to this project, then please create a fork of it in your own Github account before making changes.

2. Navigate to project directory: Once the cloning process is complete, navigate to the project directory:

   cd developer-docs

3. Install dependencies: Install the project dependencies using npm:

   npm install

   Alternatively, if you prefer using yarn:

   yarn install

Making Changes

1. Edit markdown files: Make changes to the markdown (.md) files located in the src/docs folder to update the content as needed.

2. Preview changes: After making your modifications, run the following command to preview the changes locally:

   npm run dev

   This will start a local development server, allowing you to view your changes in a web browser. You can now view your changes by visiting https://localhost:8080.

Using GitPod

Alternatively, you can open this project in GitPod for a hassle-free development experience.

Contributing changes

To contribute changes back to this project, please follow the steps outlined in the CONTRIBUTING.md file in this repository.

By following these steps, you can seamlessly work on this site locally and contribute to improving our developer documentation.