Contribute via GitHub

Fork the repository

Go to github.com/warakacommunity/AfriPlaybook and click Fork (top-right corner). This creates your own copy under your GitHub account.

Clone your fork locally

Replace YOUR-USERNAME with your GitHub username:

git clone https://github.com/YOUR-USERNAME/AfriPlaybook.git
cd AfriPlaybook

Create a feature branch

Never commit directly to main. Create a descriptive branch for your contribution:

git checkout -b add/your-chapter-name

Install dependencies and preview

Install packages, then start the local dev server. The site will be live at http://localhost:3000 and will hot-reload as you edit.

npm install
npm start

Make your changes

Playbook chapters live in the docs/ folder as Markdown (.md) files. Translations go in i18n/<lang>/docusaurus-plugin-content-docs/current/. Follow the contributor guidelines for frontmatter, structure, and style conventions.

Commit and push

Stage your changes, write a clear commit message, and push to your fork:

git add .
git commit -m "docs: add chapter on <topic>"
git push origin add/your-chapter-name

Open a Pull Request

GitHub will show a banner prompting you to open a PR. Click Compare & pull request, fill in the description template, and submit. A maintainer will review and respond within a few days.