Skip to content

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:

shell FULL_BUILD=false INSIDERS=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