Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
60 lines (37 loc) · 2.48 KB

CONTRIBUTING.md

File metadata and controls

60 lines (37 loc) · 2.48 KB
Raw

Contributing to the Site

All contributions to the website and the materials are welcome!

If you are interested in contributing to the association (events, meetups, etc.), see our website.

Developer Environment

For development, everything is powered by Dev Containers and GitHub Actions. See the Dev Container configuration in the repository for the versions used for the builds, in the case you need to reproduce the developer environment outside of the container.

Under the Hood

The site is built with MkDocs, MkDocs Multirepo Plugin, and Material for MkDocs.

Quick Start

For the local development without a full rebuild:

FULL_BUILD=false mkdocs serve

Editing

If you are a coding agent, see also the Copilot Instructions :)

Contribution Flow

We keep it simple. Just fork a repository and submit your changes as a pull request when ready.

Style Guide

Color Schema

The main Color scheme is built around the logo colors:

  • Blue: #326ce5
  • Red: #ff0000
  • White: #ffffff

Additional colors:

  • Dark Blue: #1a36b4
  • Gray for backgrounds and covers: #f6f5ec
  • Text and Hyperlink colors for the dark mode: #58a6ff

Deployment

The website is deployed automatically when the changes are merged into the main repository. For included repositories (governance, KCD), it is possible to manually trigger the deployment pipeline here.

License

This site by Oleg Nenashev is licensed under CC BY 4.0