Skip to main content

Contribute in 10 Minutes

Beginner

AILmanac is only "complete and always fresh" because people like you add to it. You do not need to be a developer — fixing a typo, adding a glossary term, or sharing a template are all real contributions.

The fast path​

  1. Find the page on the site and click "Edit this page" at the bottom (it opens the file on GitHub).
  2. Click the ✏️ pencil to edit in your browser. GitHub forks the repo for you automatically.
  3. Make your change in Markdown.
  4. At the bottom, write a short description and propose changes → open a pull request.
  5. A maintainer reviews it. That's it. 🎉

Prefer local? Clone the repo, then:

npm install
npm run start      # live preview at http://localhost:3000
npm run build      # must pass: it fails on broken links

The 4 rules every page follows​

Keeping these makes review fast and keeps quality high:

  1. Tag the level. Start the body with <LevelBadge level="beginner" /> (or intermediate / advanced / all).
  2. Link the source for volatile facts. Anything about model names, prices, limits, or features that changes must cite the official page — and use <VerifyNote lastVerified="YYYY-MM-DD" source="..." />. Never hard-code a model fact; link to the models table.
  3. Be opinionated, then honest. Give the recommended way first; note alternatives. Don't duplicate the official docs — link to them.
  4. Plain English, examples over theory. Short sentences. Show, don't just tell.

Page front-matter template​

---
sidebar_position: 2
title: Your Page Title
description: One sentence shown in search and previews.
keywords: [relevant, search, terms]
---

<LevelBadge level="beginner" />

Your first paragraph...

What makes a great first contribution​

  • Add a missing glossary term.
  • Add a template or prompt you already use.
  • Fix something newly shipped that a page now gets wrong (and update its lastVerified date).
  • Translate a page — see the Translation Playbook.

Licensing & sign-off​

By contributing you agree your prose is shared under CC BY 4.0 and code under MIT, and you add a Signed-off-by line (DCO) to your commits (git commit -s). Details in the governance page.

Be kind — we follow the Contributor Covenant Code of Conduct.