Demo content from demo/user-guide (0c17989)

index.md

@@ -0,0 +1,43 @@
+---
+id: welcome
+title: User Guide
+description: What f451 is and how this guide is organised.
+tags: [guide]
+lang: en
+---
+
+# User Guide
+
+f451 is a wiki whose pages live in Git. Every space you see here is a
+repository on Forgejo or GitHub; every page is a Markdown file in it. The
+wiki gives you a page tree, full-text search, an editor and a review
+workflow on top — but the file in the repository stays the single source
+of truth, and its Git history stays the page's history.
+
+Two consequences follow directly from that, and both come up throughout
+this guide:
+
+> [!NOTE]
+> **Permissions come from Git.** There is no separate role system in
+> f451. Whether you can see a space, and whether you can write to it,
+> is decided by your permissions in the underlying Forgejo or GitHub
+> repository.
+
+> [!NOTE]
+> **Nobody writes straight to the published version.** Every change —
+> yours, a colleague's, or an AI agent's — goes through a draft and a
+> review before it is published. See [[writing-a-page]].
+
+## How this guide is organised
+
+- [[getting-started]] — sign in and connect your Git account
+- [[reading-and-navigating]] — the page tree, breadcrumbs, the outline, the phone layout
+- [[search-and-graph]] — full-text search, the graph view, the link report
+- [[writing-a-page]] — draft, review, approval, and what happens on a conflict
+- [[editor-reference]] — formatting, wikilinks, callouts, images, diagrams, video
+- [[templates-and-metadata]] — starting points for new pages and structured fields
+- [[appearance-and-settings]] — theme, language, connected accounts
+- [[ai-agents]] — connecting an AI agent to a space through MCP
+- [[faq]] — short answers to recurring questions
+
+If you only read one other page, make it [[getting-started]].