---
icon: dot
---

- Status: proposed
- Deciders: Vahid Mohammadi
- Date: May 2022

## Context and Problem Statement

We need a tool for documenting projects with markdown. Which tool should we choose?

## Considered Options

- Retype
- Docsify
- Gitbook
- Read the Docs

## Decision Outcome

Chosen option: Retype. because:

- It's free and open-source
- Built-in components like [inline file-inclusion](https://retype.com/components/code-snippet/) and [mermaid flowcharts](https://retype.com/components/mermaid/)
- Easy to set up (with npm)
- Best UI
