Skip to content

4. Docs: Wiki + Website

Date: 2025-01-01

Status: accepted

Context

GIRAF needs both contributor-facing technical docs and a public-facing project site. MkDocs suits structured technical docs; Jekyll suits blog-style public content.

Decision

MkDocs wiki (aau-giraf/wiki) for contributor docs. Jekyll website (GIRAF-website) for public project information.

Consequences

Two doc systems to maintain. Clear audience separation. Contributors use markdown in wiki repo. Public content managed separately.