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

# Knowledge Base Maintenance

> How to maintain the RFFL Mintlify knowledge base without weakening source authority.

# Knowledge Base Maintenance

The Mintlify layer is a curated publishing surface. It should make RFFL data easier to browse and search without replacing canonical source files.

## Local Commands

| Command            | Purpose                                                           |
| ------------------ | ----------------------------------------------------------------- |
| `npm install`      | Install the Mintlify CLI package locally                          |
| `npm run dev`      | Preview the knowledge base locally                                |
| `npm run validate` | Validate the Mintlify build                                       |
| `npm run links`    | Check internal links                                              |
| `npm run verify`   | Run the full local verification gate before calling work complete |

## Content Workflow

1. Update canonical source files first.
2. Regenerate derived source pages when needed.
3. Update the matching `.mdx` knowledge base page.
4. Run `npm run verify`.
5. Fix any failed checks before reporting the change as complete.
6. Commit the source and knowledge base changes together.

## Runbooks

| Page                                                         | Use it for                                                    |
| ------------------------------------------------------------ | ------------------------------------------------------------- |
| [Source Conversion](/operations/source-conversion)           | converting raw source files into public MDX                   |
| [Publication Checklist](/operations/publication-checklist)   | pre-publish content checks                                    |
| [Verification Checklist](/operations/verification-checklist) | required local tests and browser checks                       |
| [Add Season Or Source](/operations/add-season-source)        | adding new season/source coverage without weakening authority |

## Publication Rules

| Rule                               | Reason                                                   |
| ---------------------------------- | -------------------------------------------------------- |
| Do not publish raw CSVs by default | They are source evidence, not member-facing explanations |
| Do not publish scripts by default  | They are implementation, not knowledge base content      |
| Do not invent missing data         | Keeps verification status honest                         |
| Keep source paths visible          | Makes answers traceable                                  |
| Mark provisional pages clearly     | Prevents uncertain data from becoming accepted by search |

## Season Coverage Rules

| Coverage     | Maintenance rule                                                                                                                          |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| 2002-2010    | Represent as founding-era historical coverage with archive-backed award recipients; require validated per-season packages for full recaps |
| 2011-present | Publish structured season pages only from source-backed season folders                                                                    |
| 2026         | Keep marked partial until the season record is complete and validated                                                                     |

## Static Site Notes

The knowledge base should stay useful as a static documentation site. Search, navigation, source paths, and validation matter more than a separate chat surface for this project.