# Articles

Articles are your internal knowledge base inside of Siit. Create or sync content once and use it everywhere—Portal, request replies, workflows, and AI. Siit centralizes your articles, keeps permissions aligned, and tracks usage so you know what helps.

**Where articles show up**

* Portal → Knowledge base: searchable, categorized content for employees
* Request conversation: insert an article in a reply or workflow. Communication; renders as a rich card
* AI Assist and IT Agent: answer questions and cite articles as sources; suggest articles in Slack/Teams and the Portal

**Ways to add content**

* Write directly inside of Siit
  * Rich editor (headings, lists, images, links)
  * Draft/Publish, author attribution, categories
* Sync from your external Knowledge Base
  * Notion, Confluence, Slab
  * Choose spaces/pages to sync; updates stay in sync on a schedule
* Save Slack messages to Articles
  * Add the 🧠 reaction to any Slack message (admins)
  * Siit captures the message, thread context, and links it as a draft article
  * You’ll see a success toast in Slack; review and publish in Resources → Articles

**Governance and visibility**

* Categories: organize by team or topic (IT, HR, Policies, Security
* Audience: respect rights and article permissions
* Status: Draft vs. Published; edits create a history and keep links stable
* Source tracking: each article shows its source (Siit, Slack, Notion, Confluence, Slab)

**Analytics**

* &#x20;View requests resolved with article sends to measure deflection
* Most suggested articles tell you which questions are being asked most frequently.&#x20;

**Best practices** :bulb:

* Title articles as questions employees ask (“How do I reset my Okta MFA?”)
* Keep steps short with screenshots or GIFs; add last‑updated and owner
* Localize key content or use AI’s language‑aware suggestions
* Review top‑used and low‑rated articles monthly; retire duplicates created from Slack saves
* Link articles to services that commonly require them for pre‑submission deflection


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.siit.io/data-management/articles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
