---
title: Quick-Start Guide
---

(content:references:quickstartguide)=
# Quick-Start Guide

Welcome to the **HaCLAthon**! Because we invite an interdisciplinary mix of domain experts, planners, and coders, we offer two distinct ways to collaborate. 

Please choose the path that best fits your technical background:

::::{grid} 2

:::{grid-item-card} Path A: The Writer (Domain Experts)
**Best for:** Conceptual contributions, text, data stories, and adding images. No coding or Git knowledge required.

*   **Format:** Pure Markdown (`.md`) and editable in our Editor.
*   **Tool:** Browser-based Visual Editor (CMS).
*   **Workflow:** Click an edit button, log in with GitHub, make text changes in a WYSIWYG editor, and click "Save." We handle the rest.

Start here: **[Read the Guide for Writers](01_guide_writers.md)**
:::

:::{grid-item-card} Path B: The Developer (Coders)
**Best for:** Spatial analysis, interactive maps, API retrieval, and Python/R code.

*   **Format:** Jupyter Notebooks (`.ipynb`).
*   **Tool:** Jupyter4NFDI, Carto-Lab Docker, or local environments.
*   **Workflow:** Fork the repository, launch your Jupyter environment, write interactive code, and submit a Pull Request via Git.

Start here: **[Read the Guide for Developers](02_guide_developers.md)**
:::

::::