Contributing

Set up environment

In order to follow the steps below, you’ll need to have both Git, uv and Quarto installed on your machine.

• Fork the Github repo
• Git clone it:

git clone https://github.com/YourUsername/python-packaging-essentials.git

• Create a new Git branch

git checkout -b branch-name

• Set up your environment

MacOS/Unix-like

uv python install
uv sync
source .venv/bin/activate

Windows

uv python install
uv sync
.venv\Scripts\activate

Make changes

Each blog post lives in a Quarto file (.qmd). It’s a mix of markdown and chunk of code.

You can preview locally your changes with:

quarto preview

If not done automatically, open your browser at http://localhost:4000/