--- name: ado-wiki description: Create and update Azure DevOps Wiki pages with consistent formatting. Use when asked to create wiki page, write wiki documentation, update wiki article, or work with ADO wiki. Includes page structure templates, formatting syntax, and API versioning requirements. --- # ADO Wiki Pages ## Page Structure Every wiki page follows this structure: 1. **TOC**: `[[_TOC_]]` at the top 2. **Version\/Author**: Link to version history + author name (human, not agent) 3. **What**: Brief statement of what the document helps achieve 4. **Why**: Short explanation of why this is needed 5. **Quick Start Checklist**: Actions with responsible parties, each linking to detail sections 6. **Detail Sections**: Background and step-by-step instructions 7. **Version History**: Final section with table (when, who, brief what) ## Header Formatting ```markdown # Main Header ``` Add `` above every header for readability. **TOC control**: Use `#` sparingly—only main actions should appear in TOC. Prefer `**bold text**` over sub-headers to avoid TOC clutter. ## Syntax Reference **Links** (open in new tab): ```html Open in new tab: Link Text<\/a> ``` **Colored text**: ```html Pending - WIP<\/span> ``` **Collapsible sections** (for explanations, screenshots, background info): ```html

Explanation\/Reasoning\/Screenshots<\/summary>
{content here}
<\/details>
``` ## API: Updating Wiki Pages **Critical**: Always include `version` parameter when updating existing pages. ### Workflow 1. **Get current page with version**: ```json RTPI-ADO-beta:get-wiki-page { "pagePath": "\/Page%2DName", "project": "RTPI", "wikiId": "5a23b2eb-0059-44f9-a233-24bc57dd6627", "includeContent": true } ``` 2. **Extract version from response** (ETag for concurrency control): ```json { "version": "\"990948f603ba55253206f2e0f525b9c8d5fb4fb4\"", ... } ``` 3. **Include version in update**: ```json RTPI-ADO-beta:update-wiki-page { "content": "new content", "pagePath": "\/Page%2DName", "project": "RTPI", "wikiId": "5a23b2eb-0059-44f9-a233-24bc57dd6627", "version": "\"990948f603ba55253206f2e0f525b9c8d5fb4fb4\"" } ``` | Operation | Version Required? | |--------------------------------------|-------------------| | `create-wiki-page` (new) | No | | `update-wiki-page` (existing) | **YES** | | `azuredevops-str-replace-wiki-page` | No (handled internally) | **Note**: Missing version causes misleading "page already exists" 500 error. ## Best Practices - **Shorter is better**: Move lengthy sections to sub-pages with clear links - **Quick Start is key**: This is the most important section—cut through the fluff - **Hide complexity**: Use collapsible sections for explanatory content - **Link both ways**: When creating sub-pages, backlink between them