# Mintlify Learn

## Docs

- [Control what agents see](https://learn.mintlify.com/courses/agent-friendly-docs/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.
- [How agents read your documentation](https://learn.mintlify.com/courses/agent-friendly-docs/how-agents-read-your-docs.md): AI agents process documentation differently than humans. Understand the difference to make your docs agent-friendly.
- [Keep content agent-friendly over time](https://learn.mintlify.com/courses/agent-friendly-docs/ongoing-maintenance.md): Agent-friendly documentation degrades without attention, just like any other documentation quality. Here's what to watch and when.
- [Agent-friendly documentation](https://learn.mintlify.com/courses/agent-friendly-docs/overview.md): A complete guide to making your documentation work for AI agents. What to write, how to structure it, and what to configure.
- [Write content agents can use](https://learn.mintlify.com/courses/agent-friendly-docs/write-for-agents.md): The specific writing and structural habits that make your documentation reliable context for agents.
- [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.
- [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 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.
- [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.
- [Cards as navigation](https://learn.mintlify.com/courses/components/cards-navigation.md): Use cards to guide readers to their next step.
- [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.
- [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.
- [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.
- [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.
- [When a procedure outgrows a page](https://learn.mintlify.com/courses/components/complex-procedures.md): Long procedures are harder to follow than short ones, even when they're well-written. Here's how to recognize when to split a complex procedure into multiple pages.
- [Conditional content](https://learn.mintlify.com/courses/components/conditional-content.md): Use the view component to show or hide content based on a user selection.
- [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.
- [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.
- [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.
- [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.
- [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.
- [Tabs for platform and audience variation](https://learn.mintlify.com/courses/components/tabs.md): Use tabs for content that varies based on a user's context. Misusing them hides information instead of organizing it.
- [Access and permissions](https://learn.mintlify.com/courses/git-github/access-and-permissions.md): What GitHub permissions you need to contribute to a documentation repository, and who controls what in Mintlify.
- [Best practices for branches](https://learn.mintlify.com/courses/git-github/branches.md): When to create a branch, how to name it, and what the lifecycle looks like from first edit to merged change.
- [Collaborating with your team](https://learn.mintlify.com/courses/git-github/collaborating-with-your-team.md): How to work alongside writers, engineers, and product managers without stepping on each other's changes.
- [Core Git concepts](https://learn.mintlify.com/courses/git-github/concepts-you-need.md): Git has a lot of commands and concepts. Here are the ones that matter for documentation work.
- [Get connected](https://learn.mintlify.com/courses/git-github/get-connected.md): How to create your documentation repository, install the Mintlify GitHub app, and get your site live for the first time.
- [Preview deployments](https://learn.mintlify.com/courses/git-github/mintlify-previews.md): How Mintlify generates a live preview of your changes for every pull request, and how to use it effectively.
- [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): Before learning the mechanics, it helps to understand what problems Git solves for documentation teams.
- [Workflow overview](https://learn.mintlify.com/courses/git-github/workflow.md): The practical loop from making a change to seeing it live on your documentation site.
- [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.
- [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.
- [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.
- [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.
- [Mintlify Learn](https://learn.mintlify.com/index.md): Become a Mintlify expert. Learn how the platform works, how to write great docs, and how to build a knowledge platform your users will love.