# Mintlify Learn

- [Mintlify Learn](https://learn.mintlify.com/index.md): Learn how to write great docs your users will love.
- [Structure docs that scale](https://learn.mintlify.com/courses/structure-docs/overview.md): Learn how to build documentation that stays useful as your product and team grow.
- [Understand your readers first](https://learn.mintlify.com/courses/structure-docs/understand-your-readers.md): Audience clarity is the foundation of good documentation structure. Without it, every other decision is guesswork.
- [Choose the right content type](https://learn.mintlify.com/courses/structure-docs/content-types.md): Mixing content types is one of the most common reasons documentation becomes hard to navigate — and one of the easiest problems to fix.
- [Structure individual pages for scanning](https://learn.mintlify.com/courses/structure-docs/page-structure.md): Turn a page goal into headings, prerequisites, examples, and verification that help readers move quickly.
- [Design navigation for your users (not your product)](https://learn.mintlify.com/courses/structure-docs/navigation-design.md): The most common navigation mistake is organizing around how your product is built rather than what users are trying to accomplish.
- [Measure and improve findability](https://learn.mintlify.com/courses/structure-docs/measure-and-improve.md): Use search, analytics, support questions, and task testing to find where your documentation structure fails readers.
- [Keep docs accurate as your product grows](https://learn.mintlify.com/courses/structure-docs/keeping-docs-current.md): Documentation goes stale by default. Here's how to keep it close enough to the truth that users can rely on it.
- [Git and GitHub for Mintlify](https://learn.mintlify.com/courses/git-github/overview.md): Learn how to use Git and GitHub to write, review, and publish documentation with Mintlify.
- [Why docs teams use Git](https://learn.mintlify.com/courses/git-github/why-docs-teams-use-git.md): Understand what a Git-based workflow adds to documentation review and publishing.
- [Core Git concepts](https://learn.mintlify.com/courses/git-github/concepts-you-need.md): Learn the small set of Git concepts behind the everyday documentation workflow.
- [Get connected](https://learn.mintlify.com/courses/git-github/get-connected.md): Connect a GitHub repository so Mintlify can build and deploy your documentation.
- [Access and permissions](https://learn.mintlify.com/courses/git-github/access-and-permissions.md): Identify the GitHub or Mintlify permission someone needs to do their work.
- [Set up your local environment](https://learn.mintlify.com/courses/git-github/local-setup.md): Install the tools you need, clone your documentation repository, and run your first local preview.
- [Workflow overview](https://learn.mintlify.com/courses/git-github/workflow.md): Follow a documentation change from a fresh branch through review and deployment.
- [Best practices for branches](https://learn.mintlify.com/courses/git-github/branches.md): Scope and name branches so teammates can understand, review, and merge them.
- [Preview deployments](https://learn.mintlify.com/courses/git-github/mintlify-previews.md): Use a rendered preview to review changes that a Git diff cannot show.
- [Collaborating with your team](https://learn.mintlify.com/courses/git-github/collaborating-with-your-team.md): Get useful pull request reviews, coordinate overlapping work, and resolve conflicts safely.
- [How to use Mintlify components](https://learn.mintlify.com/courses/components/overview.md): Learn which components to use and when, so your documentation stays clear and consistent.
- [Choose the right callout](https://learn.mintlify.com/courses/components/callout-types.md): Mintlify gives you a variety of callout types. Use them to send different signals to your readers.
- [When callouts stop working](https://learn.mintlify.com/courses/components/callout-fatigue.md): Callouts lose their impact if readers skip them. Learn when that happens and how to fix it.
- [Site-wide, page-level, and inline signals](https://learn.mintlify.com/courses/components/banner-tag-badge.md): Banners, tags, and badges emphasize information outside of the main content on a page.
- [Steps or numbered lists](https://learn.mintlify.com/courses/components/steps-or-lists.md): Both guide users through procedures. This lesson explains when to use each.
- [Describe branching procedures](https://learn.mintlify.com/courses/components/branching-procedures.md): When a procedure splits by platform, role, or preference, how you handle the fork determines whether users find their path or get lost.
- [When a procedure outgrows a page](https://learn.mintlify.com/courses/components/complex-procedures.md): Split a complex procedure at meaningful task boundaries so readers can make progress without losing context.
- [Progressive disclosure with accordions](https://learn.mintlify.com/courses/components/accordions.md): Use accordions to hide optional details until readers need them.
- [Code block essentials](https://learn.mintlify.com/courses/components/code-blocks.md): A few small choices in how you write code blocks determine whether users can actually follow along.
- [When to explain code and when to just show it](https://learn.mintlify.com/courses/components/code-in-context.md): How much prose to put around a code block depends on what the reader is trying to do. Over-explaining slows down experts. Under-explaining loses beginners.
- [Tabs for platform and audience variation](https://learn.mintlify.com/courses/components/tabs.md): Use tabs when readers already know which version of the content applies to them.
- [Code groups for multi-language examples](https://learn.mintlify.com/courses/components/code-groups.md): Code groups are tabs for code. Write the explanation once and let readers switch to their language.
- [Conditional content](https://learn.mintlify.com/courses/components/conditional-content.md): Use views when a reader's selection changes the structure or explanation across an entire page.
- [Tables for structured comparisons](https://learn.mintlify.com/courses/components/tables.md): Use tables when you're comparing multiple items against a consistent set of attributes.
- [Columns and cards for visual comparisons](https://learn.mintlify.com/courses/components/columns-and-cards.md): Use columns and cards when a table is too rigid or your comparison items need richer content than a cell can hold.
- [Components for API documentation](https://learn.mintlify.com/courses/components/api-components.md): Document parameters, response fields, nested objects, and request examples with components designed for API reference.
- [Images, frames, and diagrams](https://learn.mintlify.com/courses/components/visual-content.md): Choose visuals that clarify a task, then make them accessible and easy to maintain.
- [Cards as navigation](https://learn.mintlify.com/courses/components/cards-navigation.md): Use cards to guide readers to their next step.
- [Inline links or cards — when to use each one](https://learn.mintlify.com/courses/components/links-vs-cards.md): Each navigation option carries a different signal about how important the destination is. Choose the right one to guide readers to the right content.
- [End-of-page navigation patterns](https://learn.mintlify.com/courses/components/end-of-page.md): The bottom of a page can be a navigation decision point. What you put there determines whether readers continue naturally or have to figure out what comes next.
- [Small components with specific jobs](https://learn.mintlify.com/courses/components/supporting-components.md): Know when a tooltip, update, panel, prompt, tile, icon, or color swatch earns its place on the page.
- [Agent-friendly content](https://learn.mintlify.com/courses/agent-friendly-content/overview.md): A complete guide to making your content work for AI agents. What to write, how to structure it, and what to configure.
- [How agents read your content](https://learn.mintlify.com/courses/agent-friendly-content/how-agents-read-your-content.md): AI agents process content differently than humans. Understand the difference to make your content agent-friendly.
- [Write content agents can use](https://learn.mintlify.com/courses/agent-friendly-content/write-for-agents.md): The specific writing and structural habits that make your content reliable context for agents.
- [Control what agents see](https://learn.mintlify.com/courses/agent-friendly-content/control-what-agents-see.md): Which settings and files to configure, including `llms.txt`, `AGENTS.md`, `SKILL.md`, and `CLAUDE.md` to give agents the context they need.
- [Test whether agents can use your content](https://learn.mintlify.com/courses/agent-friendly-content/test-agent-readiness.md): Create a small set of questions you can rerun to catch answers that are wrong, incomplete, or unsupported before your users do.
- [Protect private and sensitive information](https://learn.mintlify.com/courses/agent-friendly-content/security-and-access.md): Separate content discovery from access control, keep secrets out of examples, and test what each audience can retrieve.
- [Keep content agent-friendly over time](https://learn.mintlify.com/courses/agent-friendly-content/ongoing-maintenance.md): Agent-friendly content degrades without attention, just like any other content quality. Here's what to watch and when.