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

# Articles

Create, edit, publish, version, search, and maintain knowledge articles.

# Articles

Knowledge articles are Markdown-like support documents stored per project.

## Article Fields

| Field | Description |
| --- | --- |
| `title` | Article title. |
| `slug` | Public or internal article path. |
| `content` | Article body. |
| `category` | Optional category label. |
| `status` | `draft` or `published`. |
| `is_public` | Whether it can appear in public docs and widget search. |
| `ai_generated` | Whether AI generated the article. |
| `external_source` | Source label such as `holydocs`. |
| `external_id` | Stable external source key. |
| `external_url` | Original article URL. |
| `locale` | Source locale. |

## Publish Flow

**Draft**

Create or import the article as a draft when content is incomplete.
  **Review**

Check accuracy, tone, policy, links, and customer-facing clarity.
  **Publish**

Publish the article so it can be indexed and used by the widget and agent.
  **Measure**

Watch views, helpfulness, failed searches, and related conversations.

## Version History

Article snapshots are recorded on create, update, and publish. Use version history to compare changes or roll back after a bad edit.

## Good Article Pattern

```md
# Short, customer-language title

One-sentence answer.

## When to use this

Explain the situation.

## Steps

1. Do the first thing.
2. Do the second thing.
3. Confirm the result.

## Still need help?

Tell the customer what context to send.
```