> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ai2fin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DOCS SEO

# Docs SEO – Max search visibility (Mintlify)

Best practices so **docs.ai2fin.com** stays fully indexable and ranks well. See [Mintlify: Hidden pages](https://www.mintlify.com/docs/organize/hidden-pages#understanding-hidden-vs-noindex) and [Mintlify: SEO](https://www.mintlify.com/docs/optimize/seo).

***

## Hidden vs noindex (use correctly)

| Goal                                 | Use                                                          | Effect                                              |
| ------------------------------------ | ------------------------------------------------------------ | --------------------------------------------------- |
| **Page in nav + in Google**          | Don’t set `hidden` or `noindex`                              | Default: indexed, in sitemap, in AI context.        |
| **Page in nav, NOT in Google**       | `noindex: true` in frontmatter only                          | Visible in sidebar; excluded from search + sitemap. |
| **Page NOT in nav, still in Google** | `hidden: true` + global `seo.indexing: "all"` in `docs.json` | Hidden from nav; still indexed (we use this).       |
| **Page NOT in nav, NOT in Google**   | `hidden: true` (and do **not** set `indexing: "all"`)        | Hidden and not indexed.                             |

* **`hidden: true`** → Mintlify also excludes from search/sitemap **unless** you set `seo.indexing: "all"` in `docs.json` (we do).
* **`noindex: true`** → Only affects indexing; page stays in nav.

For **maximum search visibility**: avoid `noindex` on any page you want discoverable. Use `hidden` only for pages you want out of the nav but still indexable (with `indexing: "all"`).

***

## What’s configured in this repo

* **`docs.json` → `seo`**
  * `indexing: "all"` – All pages (including hidden) are eligible for indexing and AI context.
  * `metatags.canonical`: `https://docs.ai2fin.com` – Canonical base URL to avoid duplicate content.
  * Title, description, keywords, `og`, `twitter` – Used for all pages unless overridden in frontmatter.

Mintlify auto-generates **sitemap** and **robots.txt**; no extra config needed for that.

***

## Checklist for new or edited pages

1. **Default** – No frontmatter `noindex` or `hidden` if you want the page in nav and in Google.
2. **Draft / internal-only** – Add `noindex: true` in frontmatter so it stays in nav but not in search.
3. **In nav but not in search** – Only if you have a strong reason; use `noindex: true` in frontmatter.
4. **Optional** – Add page-specific `title` / `description` in frontmatter for better snippets.

***

## After deploy

* In [Google Search Console](https://search.google.com/search-console) for `docs.ai2fin.com`: submit sitemap, check “Page indexing” and fix any issues.
* Ensure no site-wide noindex in Mintlify Cloud dashboard (if you use it).