[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-elastic-docs-check-style":3,"mdc--w97qpx-key":36,"related-org-elastic-docs-check-style":2461,"related-repo-elastic-docs-check-style":2634},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":23,"repoUrl":24,"updatedAt":25,"license":26,"forks":27,"topics":28,"repo":31,"sourceUrl":34,"mdContent":35},"docs-check-style","check documentation for Elastic style compliance","Check documentation for Elastic style guide compliance using Vale linter output and style rules. Use when writing, editing, or reviewing docs to catch voice, tone, grammar, formatting, accessibility, and word choice issues.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"elastic","Elastic","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Felastic.png",[12,16,19,20],{"name":13,"slug":14,"type":15},"Accessibility","accessibility","tag",{"name":17,"slug":18,"type":15},"Documentation","documentation",{"name":9,"slug":8,"type":15},{"name":21,"slug":22,"type":15},"Technical Writing","technical-writing",71,"https:\u002F\u002Fgithub.com\u002Felastic\u002Felastic-docs-skills","2026-07-12T07:49:36.112751",null,9,[29,8,30],"docs","skills",{"repoUrl":24,"stars":23,"forks":27,"topics":32,"description":33},[29,8,30],"Instructions for code agents on how to author Elastic docs","https:\u002F\u002Fgithub.com\u002Felastic\u002Felastic-docs-skills\u002Ftree\u002FHEAD\u002Fskills\u002Freview\u002Fdocs-check-style","---\nname: docs-check-style\nversion: 1.2.0\ndescription: Check documentation for Elastic style guide compliance using Vale linter output and style rules. Use when writing, editing, or reviewing docs to catch voice, tone, grammar, formatting, accessibility, and word choice issues.\nargument-hint: \u003Cfile-or-directory>\ncontext: fork\nallowed-tools: Read, Grep, Glob, Bash(vale *), CallMcpTool, WebFetch\nsources:\n  - https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\n  - https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Fvoice-tone\n  - https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Faccessibility\n  - https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Fgrammar-spelling\n  - https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Fword-choice\n  - https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Fformatting\n  - https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Fui-writing\n---\n\u003C!-- Copyright Elasticsearch B.V. and\u002For licensed to Elasticsearch B.V. under one\nor more contributor license agreements. See the NOTICE file distributed with\nthis work for additional information regarding copyright\nownership. Elasticsearch B.V. licenses this file to you under\nthe Apache License, Version 2.0 (the \"License\"); you may\nnot use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n\thttp:\u002F\u002Fwww.apache.org\u002Flicenses\u002FLICENSE-2.0\n\nUnless required by applicable law or agreed to in writing,\nsoftware distributed under the License is distributed on an\n\"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\nKIND, either express or implied.  See the License for the\nspecific language governing permissions and limitations\nunder the License. -->\n\nYou are a style reviewer for Elastic documentation. Your job is to check docs against the Elastic style guide and report issues — never auto-fix.\n\n## Inputs\n\n`$ARGUMENTS` is the file or directory to check. If empty, ask the user what to review.\n\n## Step 1: Refresh style guidance\n\nUse the Elastic docs MCP `get_document_by_url` tool with `includeBody: true` to fetch the style guide pages listed in `sources`. If the MCP is unavailable, fetch the `.md` page URLs directly. Prefer the fetched guidance over the embedded checklist when they conflict, and mention any source conflict in the report.\n\n## Step 2: Run Vale\n\nRun the Vale CLI:\n\n```\nvale --output=line $ARGUMENTS\n```\n\nIf Vale is not installed, skip this step and note it in your report. Proceed with manual review.\n\n## Step 3: Read the document(s)\n\nGlob for `.md` files in `$ARGUMENTS` (or read the single file). Read each file fully.\n\n## Step 4: Review against style rules\n\nCheck every document against the rules below. Categorize each issue by area.\n\n---\n\n### Voice and tone\n\n- **Active voice**: Prefer active over passive. Passive is acceptable only when active sounds awkward.\n- **Present tense**: Write in present tense. Avoid \"will,\" \"would,\" \"should,\" \"could,\" \"currently,\" \"now.\"\n- **Second person**: Use \"you\u002Fyour\u002Fyours.\" Never use \"I\u002Fme\u002Fmy.\" Use \"we\" sparingly (\"we recommend\" is OK).\n- **No \"please\"**: Remove \"please\" from instructions. Exception: when users must wait or face inconvenience.\n- **Contractions**: Use them for conversational tone. Don't mix contractions with spelled-out equivalents in the same context. Avoid ambiguous contractions (\"there'd,\" \"it'll,\" \"they'd\").\n- **Concise sentences**: Limit conjunctions to two per sentence. Prefer simple present over gerunds in prose.\n- **Informational tone**: Most docs should be direct, neutral, and scannable. Reserve friendly\u002Fstimulating tones for tutorials and release highlights.\n\n### Word choice\n\nFlag any usage that conflicts with this table:\n\n| Word | Status | Guidance |\n|------|--------|----------|\n| abort | Avoid | Offensive. Use _shut down_, _cancel_, or _stop_. |\n| above | Caution | Don't use for positional references — fails accessibility. |\n| add | Preferred | Establishing a new relationship. Opposite: _remove_. |\n| app, application | Caution | Use _app_ only when needed for clarity. |\n| begin | Caution | Context-dependent. Less formal than _start_. Opposite: _end_. |\n| below | Caution | Don't use for positional references — fails accessibility. |\n| blacklist | Avoid | Rooted in racism. Use _blocklist_. |\n| boot | Avoid | Use _start_ or _run_. |\n| can | Preferred | Conveys permission. |\n| cancel | Preferred | Stop an action without saving pending changes. |\n| cannot, can't | Preferred | Indicates inability. Often confused with _unable_. |\n| choose | Avoid | Use _select_. |\n| click | Caution | OK for mouse actions. Otherwise use device-neutral verbs like _select_. |\n| clone | Caution | Copy linked to the original. Distinct from _copy_ and _duplicate_. |\n| copy | Caution | Exact copy in same location. Distinct from _clone_ and _duplicate_. |\n| could | Avoid | Use _can_ or _might_. |\n| create | Preferred | Creating from scratch. Not \"create new.\" Opposite: _delete_. |\n| delete | Preferred | Data permanently unavailable to users. Opposite: _create_. |\n| disable | Caution | Don't use for broken things. Use _inactive_, _unavailable_, _deactivate_, _turn off_, or _deselect_ depending on context. |\n| duplicate | Caution | Copy in same location. Distinct from _copy_ and _clone_. |\n| easy, easily | Avoid | Frustrating when users struggle. Remove — same meaning without it. |\n| edit | Preferred | Not _change_ or _modify_. Better for localization. |\n| e.g. | Avoid | Use _for example_ or _such as_. |\n| enable | Preferred | Turning on or activating a feature. |\n| enter | Preferred | User text input. Not _type_. |\n| execute | Avoid | Use _run_ or _start_. |\n| hack | Avoid | Noun: _tip_ or _work-around_. Verb: _configure_ or _modify_. |\n| hit | Avoid | Noun: _visits_. Verb: _click_ or _press_. |\n| i.e. | Avoid | Don't use Latin abbreviations. |\n| invalid | Avoid | Use _not valid_ or _incorrect_. |\n| kill | Caution | Use _cancel_ or _stop_ unless the actual command is `kill`. |\n| launch | Avoid | Use _open_. |\n| may | Caution | _may_ = permissibility, _can_ = capability, _might_ = possibility. |\n| open | Preferred | Use instead of _launch_. |\n| please | Avoid | Unnecessary except when users must wait or face inconvenience. |\n| remove | Preferred | Removes a relationship, not data. Opposite: _add_. |\n| select | Preferred | Preferred over _choose_. |\n| simple, simply | Avoid | Adds no value. Implies users shouldn't need help. |\n| start | Caution | Context-dependent. Less formal than _begin_. |\n| terminate | Avoid | Use _stop_ or _exit_. |\n| type | Avoid | Use _enter_ — accommodates multiple input methods. |\n| unable | Caution | Means not being able to perform an action. Distinct from _cannot_. |\n| utilize | Caution | Use _use_ instead. |\n| view | Preferred | More inclusive than _see_. |\n| whitelist | Avoid | Use _allowlist_. |\n\nAlso flag Latin abbreviations: replace \"e.g.\" with \"for example,\" \"i.e.\" with \"that is,\" \"etc.\" with \"and more,\" \"via\" with \"through.\"\n\n### Grammar and spelling\n\n- **American English**: -ize\u002F-yze verbs, -or nouns, -ense nouns, -og nouns (organize, color, license, dialog).\n- **Oxford comma**: Always use in lists of three or more.\n- **Abbreviations**: Spell out on first use. Pluralize without apostrophes (APIs, SDKs, OSes).\n- **Capitalization**: Sentence-style for headings. Capitalize proper nouns and product names only. Don't capitalize spelled-out acronyms unless proper nouns. Match UI capitalization.\n- **Hyphens**: Compound adjectives before nouns (real-time results), two vowels together (re-enable), self-\u002Fex-\u002Fall- prefixes. No hyphen for predicate adjectives (\"up to date\") or adverbs ending in -ly (\"newly installed\").\n- **Gerunds**: Use in top-level task titles. Use action verbs in lower-level titles. Avoid gerunds in prepositional phrases (\"how to configure\" not \"on configuring\").\n- **Noun vs. verb compounds**: backup\u002Fback up, login\u002Flog in, setup\u002Fset up, startup\u002Fstart up.\n- **Quotation marks**: Use double quotation marks to quote error messages or introduce an unfamiliar term on first use only. Do **not** use quotation marks for code\u002Fcommands (use monospace instead), for emphasis (use bold or italic), or for product\u002Ffeature\u002FUI names. Place commas and periods **inside** closing quotation marks. Place colons, semicolons, question marks, and exclamation points **outside** closing quotation marks (unless part of the quoted material). Use single quotation marks only for quotations within quotations.\n\n### Formatting\n\n- **Bold**: UI element names (apps, buttons, menu items, page names, tabs, columns).\n- **Italic**: New terms and concepts, Elastic documentation resource titles.\n- **Monospace**: API endpoints, class names, code, commands, config settings, data types, directories, env vars, error messages, field names, function names, index names, parameters, process names, property names, role names, variables.\n- **Numbers**: Write out 1–9 in prose, numerals for 10+. Use numerals in tables, for decimals, dimensions, percentages. Separate large numbers with commas (1,234,567).\n- **Dates and times**: Use `Month DD, YYYY` for dates. Use 12-hour time with uppercase `AM`\u002F`PM`. Use UTC as the primary time zone, or include UTC with local time when needed. Avoid relative terms such as \"last month,\" \"recently,\" and \"currently.\"\n- **Lists**: Minimum two items. Parallel structure. Capitalize first letter. No periods unless complete sentences. Introduce with a heading, sentence, or fragment ending with a colon.\n- **Paragraphs**: Keep under seven lines.\n- **Line spacing**: Single line break between elements.\n- **Admonitions**: Use notes, tips, warnings, important blocks, and plain admonitions for their documented purpose. Do not stack admonitions, overuse them, or use regular admonitions for prerequisites when a plain requirements admonition fits better.\n- **Code samples**: Use consistent indentation, syntax highlighting, runnable examples when possible, and short comments before the code they explain. For JSON, use footnotes only when needed because footnotes are less accessible.\n- **Sensitive information**: Flag screenshots, examples, logs, tokens, hostnames, IPs, internal links, customer data, and secrets that need redaction or replacement with documentation-safe placeholders.\n\n### Accessibility\n\n- **Alt text**: Required for all images, icons, and media. No backticks in alt text.\n- **Link text**: Descriptive — never \"click here\" or bare URLs.\n- **No directional language**: Avoid \"above,\" \"below,\" \"left,\" \"right\" for positional references.\n- **Device-neutral verbs**: Prefer device-neutral language. Use \"select\" for choices — tabs, checkboxes, dropdowns, and radio buttons. Use \"click\" for button actions, icons, and following links. Avoid \"click\" when the user is making a selection rather than triggering an action.\n- **Plain language**: Short sentences. Expand acronyms on first use. Parallel structures in lists.\n- **Gender-neutral**: Use they\u002Ftheir. Replace gendered defaults (use \"folks\" not \"guys\").\n- **Avoid**: Buzzwords, superhero terms, violent imagery, ableist language, non-specific superlatives.\n\n### UI writing\n\n- **Buttons**: \"Click **Save**\" — don't add \"button\" after the label.\n- **Checkboxes\u002Fradio buttons**: \"Select **Logs**\" \u002F \"Clear **Metrics**.\"\n- **Select vs. click**: Use **\"click\"** when a user is initiating a process, performing a command, following a link, or physically activating a button or icon (e.g., \"Click **Save**\", \"Click the **Help** icon\"). Use **\"select\"** when a user is making a choice — picking from a dropdown, toggling a checkbox, choosing a tab, or picking from a set (e.g., \"Select the **Logs** tab\", \"Select the **Enforce HTTPS** checkbox\"). ❌ \"Select the **Save** button to confirm your changes\" \u002F ✅ \"Click **Save** to confirm your changes\". ❌ \"Click **Logs**\" [for a tab] \u002F ✅ \"Select the **Logs** tab to view events\".\n- **Text fields**: \"In the **Name** field, enter `value`.\"\n- **Toggles**: \"Turn on **Feature**\" \u002F \"Turn off **Feature**\" — not \"enable\u002Fdisable\" as verbs. Use \"toggle\" as a **noun** to refer to the UI element (e.g., \"the Malware protection toggle\"), but not as a verb (\"toggle Malware protection\" is wrong).\n- **Keys**: \"Press Enter\" \u002F \"Press Command+Alt+L.\"\n- **Menus**: Use arrows for navigation — \"Select **Manage index → Add lifecycle policy**.\" Do **not** use the verbs \"open\" or \"close\" for menus; use \"From the menu,...\" instead. Refer to the element as \"menu\" — not \"dropdown menu\" or \"dropdown list.\"\n- **Icons**: Reference by tooltip text, include inline icon. Avoid parentheses around icons.\n- **Screenshots**: Use screenshots sparingly for complex UI, introductions, or timebound content. Check that screenshots use a consistent aspect ratio, 100% zoom, only essential UI, a screenshot border when appropriate, accessible alt text, and no sensitive information.\n- **Procedures**: 5–9 steps. Focus on use cases, not piece-by-piece UI description. Eliminate obvious steps.\n- **Prepositions**: \"in\" a field\u002Fwindow\u002Fmenu, \"on\" a page\u002Ftab, \"from\" a list\u002Fcommand line, \"at\" the command prompt.\n- **Referring to apps and pages**: In Kibana, navigation can vary by environment. Use solution-agnostic patterns when directing users to apps or pages: \"Find **APP** in the navigation menu or use the [global search field].\" When the app is only reachable via search: \"To open **APP**, find **PARENT** in the navigation menu or use the global search field.\" Flag instructions that assume a fixed navigation path without offering the search alternative.\n- **Naming Kibana UI elements**: Use the canonical names for parts of the Kibana chrome. Flag any other variants you see.\n\n  | Term | What it refers to | Variants to flag |\n  |---|---|---|\n  | **Global header** | The top bar of the Kibana chrome that hosts global controls. | \"Kibana header\" alone |\n  | **Navigation menu** | The primary navigation panel on the left side of Kibana. | \"main menu\", \"side navigation\", \"side nav\", \"sidenav\", \"navbar\", \"primary navigation\" |\n  | **Solution view** | The per-space setting that controls the navigation menu. | — |\n  | **Classic view** | The non-solution option in the **Solution view** setting. | \"Classic navigation\", bare \"Classic\" when ambiguous with Discover's Classic mode |\n  | **Secondary navigation** | The panel that opens next to the navigation menu for nested items. | \"secondary nav menu\", \"secondary nav panel\" alone |\n  | **Application menu** | The bar above the workspace that hosts app-specific actions. | \"App menu bar\", \"app menu\" |\n  | **Workspace** | The main content area of the current app. | \"App workspace\" |\n  | **Flyout** | A panel that slides in from the right of the workspace. | \"flyout session\", \"grouped flyout\" (these are internal terms) |\n  | **Sidebar** | The global, resizable right-hand panel where plugins register apps. | — |\n\nWhen a generic word-choice rule conflicts with UI writing, prefer the UI-specific rule. For example, `click` is correct for action buttons and icons, while `select` is correct for choices such as tabs, checkboxes, radio buttons, and dropdown options.\n\n---\n\n## Step 5: Generate the report\n\nPresent findings as a structured report. Group issues by area. For each issue:\n\n1. **File and line** — `path\u002Fto\u002Ffile.md:42`\n2. **Area** — one of: Voice\u002FTone, Word Choice, Grammar\u002FSpelling, Formatting, Accessibility, UI Writing\n3. **Issue** — what's wrong\n4. **Suggestion** — how to fix it\n\n### Report format\n\n```\n## Style review: \u003Cfile or directory>\n\n### Summary\n- X issues found (Y from Vale, Z from manual review)\n- Breakdown by area: ...\n\n### Issues\n\n#### Voice and tone\n- `file.md:12` — Passive voice: \"Settings can be configured...\" → \"You can configure settings...\"\n\n#### Word choice\n- `file.md:25` — Avoid \"click\" for device-neutral context → use \"select\"\n- `file.md:30` — Latin abbreviation \"e.g.\" → \"for example\"\n\n...\n```\n\nIf no issues are found, say so. Always end with a one-line summary.\n\n## Style guide reference\n\nFor deeper investigation, consult these pages:\n\n- [Style guide overview](https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide)\n- [Voice and tone](https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Fvoice-tone)\n- [Accessibility](https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Faccessibility)\n- [Grammar and spelling](https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Fgrammar-spelling)\n- [Word choice](https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Fword-choice)\n- [Formatting](https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Fformatting)\n- [UI writing](https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Fui-writing)\n",{"data":37,"body":50},{"name":4,"version":38,"description":6,"argument-hint":39,"context":40,"allowed-tools":41,"sources":42},"1.2.0","\u003Cfile-or-directory>","fork","Read, Grep, Glob, Bash(vale *), CallMcpTool, WebFetch",[43,44,45,46,47,48,49],"https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide","https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Fvoice-tone","https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Faccessibility","https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Fgrammar-spelling","https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Fword-choice","https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Fformatting","https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fcontribute-docs\u002Fstyle-guide\u002Fui-writing",{"type":51,"children":52},"root",[53,61,68,80,86,123,129,134,146,151,157,176,182,187,191,198,274,280,285,1425,1430,1436,1540,1546,1683,1687,1759,1765,2285,2304,2307,2313,2318,2368,2374,2383,2388,2394,2399],{"type":54,"tag":55,"props":56,"children":57},"element","p",{},[58],{"type":59,"value":60},"text","You are a style reviewer for Elastic documentation. Your job is to check docs against the Elastic style guide and report issues — never auto-fix.",{"type":54,"tag":62,"props":63,"children":65},"h2",{"id":64},"inputs",[66],{"type":59,"value":67},"Inputs",{"type":54,"tag":55,"props":69,"children":70},{},[71,78],{"type":54,"tag":72,"props":73,"children":75},"code",{"className":74},[],[76],{"type":59,"value":77},"$ARGUMENTS",{"type":59,"value":79}," is the file or directory to check. If empty, ask the user what to review.",{"type":54,"tag":62,"props":81,"children":83},{"id":82},"step-1-refresh-style-guidance",[84],{"type":59,"value":85},"Step 1: Refresh style guidance",{"type":54,"tag":55,"props":87,"children":88},{},[89,91,97,99,105,107,113,115,121],{"type":59,"value":90},"Use the Elastic docs MCP ",{"type":54,"tag":72,"props":92,"children":94},{"className":93},[],[95],{"type":59,"value":96},"get_document_by_url",{"type":59,"value":98}," tool with ",{"type":54,"tag":72,"props":100,"children":102},{"className":101},[],[103],{"type":59,"value":104},"includeBody: true",{"type":59,"value":106}," to fetch the style guide pages listed in ",{"type":54,"tag":72,"props":108,"children":110},{"className":109},[],[111],{"type":59,"value":112},"sources",{"type":59,"value":114},". If the MCP is unavailable, fetch the ",{"type":54,"tag":72,"props":116,"children":118},{"className":117},[],[119],{"type":59,"value":120},".md",{"type":59,"value":122}," page URLs directly. Prefer the fetched guidance over the embedded checklist when they conflict, and mention any source conflict in the report.",{"type":54,"tag":62,"props":124,"children":126},{"id":125},"step-2-run-vale",[127],{"type":59,"value":128},"Step 2: Run Vale",{"type":54,"tag":55,"props":130,"children":131},{},[132],{"type":59,"value":133},"Run the Vale CLI:",{"type":54,"tag":135,"props":136,"children":140},"pre",{"className":137,"code":139,"language":59},[138],"language-text","vale --output=line $ARGUMENTS\n",[141],{"type":54,"tag":72,"props":142,"children":144},{"__ignoreMap":143},"",[145],{"type":59,"value":139},{"type":54,"tag":55,"props":147,"children":148},{},[149],{"type":59,"value":150},"If Vale is not installed, skip this step and note it in your report. Proceed with manual review.",{"type":54,"tag":62,"props":152,"children":154},{"id":153},"step-3-read-the-documents",[155],{"type":59,"value":156},"Step 3: Read the document(s)",{"type":54,"tag":55,"props":158,"children":159},{},[160,162,167,169,174],{"type":59,"value":161},"Glob for ",{"type":54,"tag":72,"props":163,"children":165},{"className":164},[],[166],{"type":59,"value":120},{"type":59,"value":168}," files in ",{"type":54,"tag":72,"props":170,"children":172},{"className":171},[],[173],{"type":59,"value":77},{"type":59,"value":175}," (or read the single file). Read each file fully.",{"type":54,"tag":62,"props":177,"children":179},{"id":178},"step-4-review-against-style-rules",[180],{"type":59,"value":181},"Step 4: Review against style rules",{"type":54,"tag":55,"props":183,"children":184},{},[185],{"type":59,"value":186},"Check every document against the rules below. Categorize each issue by area.",{"type":54,"tag":188,"props":189,"children":190},"hr",{},[],{"type":54,"tag":192,"props":193,"children":195},"h3",{"id":194},"voice-and-tone",[196],{"type":59,"value":197},"Voice and tone",{"type":54,"tag":199,"props":200,"children":201},"ul",{},[202,214,224,234,244,254,264],{"type":54,"tag":203,"props":204,"children":205},"li",{},[206,212],{"type":54,"tag":207,"props":208,"children":209},"strong",{},[210],{"type":59,"value":211},"Active voice",{"type":59,"value":213},": Prefer active over passive. Passive is acceptable only when active sounds awkward.",{"type":54,"tag":203,"props":215,"children":216},{},[217,222],{"type":54,"tag":207,"props":218,"children":219},{},[220],{"type":59,"value":221},"Present tense",{"type":59,"value":223},": Write in present tense. Avoid \"will,\" \"would,\" \"should,\" \"could,\" \"currently,\" \"now.\"",{"type":54,"tag":203,"props":225,"children":226},{},[227,232],{"type":54,"tag":207,"props":228,"children":229},{},[230],{"type":59,"value":231},"Second person",{"type":59,"value":233},": Use \"you\u002Fyour\u002Fyours.\" Never use \"I\u002Fme\u002Fmy.\" Use \"we\" sparingly (\"we recommend\" is OK).",{"type":54,"tag":203,"props":235,"children":236},{},[237,242],{"type":54,"tag":207,"props":238,"children":239},{},[240],{"type":59,"value":241},"No \"please\"",{"type":59,"value":243},": Remove \"please\" from instructions. Exception: when users must wait or face inconvenience.",{"type":54,"tag":203,"props":245,"children":246},{},[247,252],{"type":54,"tag":207,"props":248,"children":249},{},[250],{"type":59,"value":251},"Contractions",{"type":59,"value":253},": Use them for conversational tone. Don't mix contractions with spelled-out equivalents in the same context. Avoid ambiguous contractions (\"there'd,\" \"it'll,\" \"they'd\").",{"type":54,"tag":203,"props":255,"children":256},{},[257,262],{"type":54,"tag":207,"props":258,"children":259},{},[260],{"type":59,"value":261},"Concise sentences",{"type":59,"value":263},": Limit conjunctions to two per sentence. Prefer simple present over gerunds in prose.",{"type":54,"tag":203,"props":265,"children":266},{},[267,272],{"type":54,"tag":207,"props":268,"children":269},{},[270],{"type":59,"value":271},"Informational tone",{"type":59,"value":273},": Most docs should be direct, neutral, and scannable. Reserve friendly\u002Fstimulating tones for tutorials and release highlights.",{"type":54,"tag":192,"props":275,"children":277},{"id":276},"word-choice",[278],{"type":59,"value":279},"Word choice",{"type":54,"tag":55,"props":281,"children":282},{},[283],{"type":59,"value":284},"Flag any usage that conflicts with this table:",{"type":54,"tag":286,"props":287,"children":288},"table",{},[289,313],{"type":54,"tag":290,"props":291,"children":292},"thead",{},[293],{"type":54,"tag":294,"props":295,"children":296},"tr",{},[297,303,308],{"type":54,"tag":298,"props":299,"children":300},"th",{},[301],{"type":59,"value":302},"Word",{"type":54,"tag":298,"props":304,"children":305},{},[306],{"type":59,"value":307},"Status",{"type":54,"tag":298,"props":309,"children":310},{},[311],{"type":59,"value":312},"Guidance",{"type":54,"tag":314,"props":315,"children":316},"tbody",{},[317,358,376,400,424,454,470,493,521,538,554,577,599,621,651,677,704,727,748,796,822,839,869,897,914,937,963,1004,1037,1054,1082,1115,1137,1170,1191,1208,1229,1250,1267,1287,1314,1335,1357,1380,1403],{"type":54,"tag":294,"props":318,"children":319},{},[320,326,331],{"type":54,"tag":321,"props":322,"children":323},"td",{},[324],{"type":59,"value":325},"abort",{"type":54,"tag":321,"props":327,"children":328},{},[329],{"type":59,"value":330},"Avoid",{"type":54,"tag":321,"props":332,"children":333},{},[334,336,342,344,349,351,356],{"type":59,"value":335},"Offensive. Use ",{"type":54,"tag":337,"props":338,"children":339},"em",{},[340],{"type":59,"value":341},"shut down",{"type":59,"value":343},", ",{"type":54,"tag":337,"props":345,"children":346},{},[347],{"type":59,"value":348},"cancel",{"type":59,"value":350},", or ",{"type":54,"tag":337,"props":352,"children":353},{},[354],{"type":59,"value":355},"stop",{"type":59,"value":357},".",{"type":54,"tag":294,"props":359,"children":360},{},[361,366,371],{"type":54,"tag":321,"props":362,"children":363},{},[364],{"type":59,"value":365},"above",{"type":54,"tag":321,"props":367,"children":368},{},[369],{"type":59,"value":370},"Caution",{"type":54,"tag":321,"props":372,"children":373},{},[374],{"type":59,"value":375},"Don't use for positional references — fails accessibility.",{"type":54,"tag":294,"props":377,"children":378},{},[379,384,389],{"type":54,"tag":321,"props":380,"children":381},{},[382],{"type":59,"value":383},"add",{"type":54,"tag":321,"props":385,"children":386},{},[387],{"type":59,"value":388},"Preferred",{"type":54,"tag":321,"props":390,"children":391},{},[392,394,399],{"type":59,"value":393},"Establishing a new relationship. Opposite: ",{"type":54,"tag":337,"props":395,"children":396},{},[397],{"type":59,"value":398},"remove",{"type":59,"value":357},{"type":54,"tag":294,"props":401,"children":402},{},[403,408,412],{"type":54,"tag":321,"props":404,"children":405},{},[406],{"type":59,"value":407},"app, application",{"type":54,"tag":321,"props":409,"children":410},{},[411],{"type":59,"value":370},{"type":54,"tag":321,"props":413,"children":414},{},[415,417,422],{"type":59,"value":416},"Use ",{"type":54,"tag":337,"props":418,"children":419},{},[420],{"type":59,"value":421},"app",{"type":59,"value":423}," only when needed for clarity.",{"type":54,"tag":294,"props":425,"children":426},{},[427,432,436],{"type":54,"tag":321,"props":428,"children":429},{},[430],{"type":59,"value":431},"begin",{"type":54,"tag":321,"props":433,"children":434},{},[435],{"type":59,"value":370},{"type":54,"tag":321,"props":437,"children":438},{},[439,441,446,448,453],{"type":59,"value":440},"Context-dependent. Less formal than ",{"type":54,"tag":337,"props":442,"children":443},{},[444],{"type":59,"value":445},"start",{"type":59,"value":447},". Opposite: ",{"type":54,"tag":337,"props":449,"children":450},{},[451],{"type":59,"value":452},"end",{"type":59,"value":357},{"type":54,"tag":294,"props":455,"children":456},{},[457,462,466],{"type":54,"tag":321,"props":458,"children":459},{},[460],{"type":59,"value":461},"below",{"type":54,"tag":321,"props":463,"children":464},{},[465],{"type":59,"value":370},{"type":54,"tag":321,"props":467,"children":468},{},[469],{"type":59,"value":375},{"type":54,"tag":294,"props":471,"children":472},{},[473,478,482],{"type":54,"tag":321,"props":474,"children":475},{},[476],{"type":59,"value":477},"blacklist",{"type":54,"tag":321,"props":479,"children":480},{},[481],{"type":59,"value":330},{"type":54,"tag":321,"props":483,"children":484},{},[485,487,492],{"type":59,"value":486},"Rooted in racism. Use ",{"type":54,"tag":337,"props":488,"children":489},{},[490],{"type":59,"value":491},"blocklist",{"type":59,"value":357},{"type":54,"tag":294,"props":494,"children":495},{},[496,501,505],{"type":54,"tag":321,"props":497,"children":498},{},[499],{"type":59,"value":500},"boot",{"type":54,"tag":321,"props":502,"children":503},{},[504],{"type":59,"value":330},{"type":54,"tag":321,"props":506,"children":507},{},[508,509,513,515,520],{"type":59,"value":416},{"type":54,"tag":337,"props":510,"children":511},{},[512],{"type":59,"value":445},{"type":59,"value":514}," or ",{"type":54,"tag":337,"props":516,"children":517},{},[518],{"type":59,"value":519},"run",{"type":59,"value":357},{"type":54,"tag":294,"props":522,"children":523},{},[524,529,533],{"type":54,"tag":321,"props":525,"children":526},{},[527],{"type":59,"value":528},"can",{"type":54,"tag":321,"props":530,"children":531},{},[532],{"type":59,"value":388},{"type":54,"tag":321,"props":534,"children":535},{},[536],{"type":59,"value":537},"Conveys permission.",{"type":54,"tag":294,"props":539,"children":540},{},[541,545,549],{"type":54,"tag":321,"props":542,"children":543},{},[544],{"type":59,"value":348},{"type":54,"tag":321,"props":546,"children":547},{},[548],{"type":59,"value":388},{"type":54,"tag":321,"props":550,"children":551},{},[552],{"type":59,"value":553},"Stop an action without saving pending changes.",{"type":54,"tag":294,"props":555,"children":556},{},[557,562,566],{"type":54,"tag":321,"props":558,"children":559},{},[560],{"type":59,"value":561},"cannot, can't",{"type":54,"tag":321,"props":563,"children":564},{},[565],{"type":59,"value":388},{"type":54,"tag":321,"props":567,"children":568},{},[569,571,576],{"type":59,"value":570},"Indicates inability. Often confused with ",{"type":54,"tag":337,"props":572,"children":573},{},[574],{"type":59,"value":575},"unable",{"type":59,"value":357},{"type":54,"tag":294,"props":578,"children":579},{},[580,585,589],{"type":54,"tag":321,"props":581,"children":582},{},[583],{"type":59,"value":584},"choose",{"type":54,"tag":321,"props":586,"children":587},{},[588],{"type":59,"value":330},{"type":54,"tag":321,"props":590,"children":591},{},[592,593,598],{"type":59,"value":416},{"type":54,"tag":337,"props":594,"children":595},{},[596],{"type":59,"value":597},"select",{"type":59,"value":357},{"type":54,"tag":294,"props":600,"children":601},{},[602,607,611],{"type":54,"tag":321,"props":603,"children":604},{},[605],{"type":59,"value":606},"click",{"type":54,"tag":321,"props":608,"children":609},{},[610],{"type":59,"value":370},{"type":54,"tag":321,"props":612,"children":613},{},[614,616,620],{"type":59,"value":615},"OK for mouse actions. Otherwise use device-neutral verbs like ",{"type":54,"tag":337,"props":617,"children":618},{},[619],{"type":59,"value":597},{"type":59,"value":357},{"type":54,"tag":294,"props":622,"children":623},{},[624,629,633],{"type":54,"tag":321,"props":625,"children":626},{},[627],{"type":59,"value":628},"clone",{"type":54,"tag":321,"props":630,"children":631},{},[632],{"type":59,"value":370},{"type":54,"tag":321,"props":634,"children":635},{},[636,638,643,645,650],{"type":59,"value":637},"Copy linked to the original. Distinct from ",{"type":54,"tag":337,"props":639,"children":640},{},[641],{"type":59,"value":642},"copy",{"type":59,"value":644}," and ",{"type":54,"tag":337,"props":646,"children":647},{},[648],{"type":59,"value":649},"duplicate",{"type":59,"value":357},{"type":54,"tag":294,"props":652,"children":653},{},[654,658,662],{"type":54,"tag":321,"props":655,"children":656},{},[657],{"type":59,"value":642},{"type":54,"tag":321,"props":659,"children":660},{},[661],{"type":59,"value":370},{"type":54,"tag":321,"props":663,"children":664},{},[665,667,671,672,676],{"type":59,"value":666},"Exact copy in same location. Distinct from ",{"type":54,"tag":337,"props":668,"children":669},{},[670],{"type":59,"value":628},{"type":59,"value":644},{"type":54,"tag":337,"props":673,"children":674},{},[675],{"type":59,"value":649},{"type":59,"value":357},{"type":54,"tag":294,"props":678,"children":679},{},[680,685,689],{"type":54,"tag":321,"props":681,"children":682},{},[683],{"type":59,"value":684},"could",{"type":54,"tag":321,"props":686,"children":687},{},[688],{"type":59,"value":330},{"type":54,"tag":321,"props":690,"children":691},{},[692,693,697,698,703],{"type":59,"value":416},{"type":54,"tag":337,"props":694,"children":695},{},[696],{"type":59,"value":528},{"type":59,"value":514},{"type":54,"tag":337,"props":699,"children":700},{},[701],{"type":59,"value":702},"might",{"type":59,"value":357},{"type":54,"tag":294,"props":705,"children":706},{},[707,712,716],{"type":54,"tag":321,"props":708,"children":709},{},[710],{"type":59,"value":711},"create",{"type":54,"tag":321,"props":713,"children":714},{},[715],{"type":59,"value":388},{"type":54,"tag":321,"props":717,"children":718},{},[719,721,726],{"type":59,"value":720},"Creating from scratch. Not \"create new.\" Opposite: ",{"type":54,"tag":337,"props":722,"children":723},{},[724],{"type":59,"value":725},"delete",{"type":59,"value":357},{"type":54,"tag":294,"props":728,"children":729},{},[730,734,738],{"type":54,"tag":321,"props":731,"children":732},{},[733],{"type":59,"value":725},{"type":54,"tag":321,"props":735,"children":736},{},[737],{"type":59,"value":388},{"type":54,"tag":321,"props":739,"children":740},{},[741,743,747],{"type":59,"value":742},"Data permanently unavailable to users. Opposite: ",{"type":54,"tag":337,"props":744,"children":745},{},[746],{"type":59,"value":711},{"type":59,"value":357},{"type":54,"tag":294,"props":749,"children":750},{},[751,756,760],{"type":54,"tag":321,"props":752,"children":753},{},[754],{"type":59,"value":755},"disable",{"type":54,"tag":321,"props":757,"children":758},{},[759],{"type":59,"value":370},{"type":54,"tag":321,"props":761,"children":762},{},[763,765,770,771,776,777,782,783,788,789,794],{"type":59,"value":764},"Don't use for broken things. Use ",{"type":54,"tag":337,"props":766,"children":767},{},[768],{"type":59,"value":769},"inactive",{"type":59,"value":343},{"type":54,"tag":337,"props":772,"children":773},{},[774],{"type":59,"value":775},"unavailable",{"type":59,"value":343},{"type":54,"tag":337,"props":778,"children":779},{},[780],{"type":59,"value":781},"deactivate",{"type":59,"value":343},{"type":54,"tag":337,"props":784,"children":785},{},[786],{"type":59,"value":787},"turn off",{"type":59,"value":350},{"type":54,"tag":337,"props":790,"children":791},{},[792],{"type":59,"value":793},"deselect",{"type":59,"value":795}," depending on context.",{"type":54,"tag":294,"props":797,"children":798},{},[799,803,807],{"type":54,"tag":321,"props":800,"children":801},{},[802],{"type":59,"value":649},{"type":54,"tag":321,"props":804,"children":805},{},[806],{"type":59,"value":370},{"type":54,"tag":321,"props":808,"children":809},{},[810,812,816,817,821],{"type":59,"value":811},"Copy in same location. Distinct from ",{"type":54,"tag":337,"props":813,"children":814},{},[815],{"type":59,"value":642},{"type":59,"value":644},{"type":54,"tag":337,"props":818,"children":819},{},[820],{"type":59,"value":628},{"type":59,"value":357},{"type":54,"tag":294,"props":823,"children":824},{},[825,830,834],{"type":54,"tag":321,"props":826,"children":827},{},[828],{"type":59,"value":829},"easy, easily",{"type":54,"tag":321,"props":831,"children":832},{},[833],{"type":59,"value":330},{"type":54,"tag":321,"props":835,"children":836},{},[837],{"type":59,"value":838},"Frustrating when users struggle. Remove — same meaning without it.",{"type":54,"tag":294,"props":840,"children":841},{},[842,847,851],{"type":54,"tag":321,"props":843,"children":844},{},[845],{"type":59,"value":846},"edit",{"type":54,"tag":321,"props":848,"children":849},{},[850],{"type":59,"value":388},{"type":54,"tag":321,"props":852,"children":853},{},[854,856,861,862,867],{"type":59,"value":855},"Not ",{"type":54,"tag":337,"props":857,"children":858},{},[859],{"type":59,"value":860},"change",{"type":59,"value":514},{"type":54,"tag":337,"props":863,"children":864},{},[865],{"type":59,"value":866},"modify",{"type":59,"value":868},". Better for localization.",{"type":54,"tag":294,"props":870,"children":871},{},[872,877,881],{"type":54,"tag":321,"props":873,"children":874},{},[875],{"type":59,"value":876},"e.g.",{"type":54,"tag":321,"props":878,"children":879},{},[880],{"type":59,"value":330},{"type":54,"tag":321,"props":882,"children":883},{},[884,885,890,891,896],{"type":59,"value":416},{"type":54,"tag":337,"props":886,"children":887},{},[888],{"type":59,"value":889},"for example",{"type":59,"value":514},{"type":54,"tag":337,"props":892,"children":893},{},[894],{"type":59,"value":895},"such as",{"type":59,"value":357},{"type":54,"tag":294,"props":898,"children":899},{},[900,905,909],{"type":54,"tag":321,"props":901,"children":902},{},[903],{"type":59,"value":904},"enable",{"type":54,"tag":321,"props":906,"children":907},{},[908],{"type":59,"value":388},{"type":54,"tag":321,"props":910,"children":911},{},[912],{"type":59,"value":913},"Turning on or activating a feature.",{"type":54,"tag":294,"props":915,"children":916},{},[917,922,926],{"type":54,"tag":321,"props":918,"children":919},{},[920],{"type":59,"value":921},"enter",{"type":54,"tag":321,"props":923,"children":924},{},[925],{"type":59,"value":388},{"type":54,"tag":321,"props":927,"children":928},{},[929,931,936],{"type":59,"value":930},"User text input. Not ",{"type":54,"tag":337,"props":932,"children":933},{},[934],{"type":59,"value":935},"type",{"type":59,"value":357},{"type":54,"tag":294,"props":938,"children":939},{},[940,945,949],{"type":54,"tag":321,"props":941,"children":942},{},[943],{"type":59,"value":944},"execute",{"type":54,"tag":321,"props":946,"children":947},{},[948],{"type":59,"value":330},{"type":54,"tag":321,"props":950,"children":951},{},[952,953,957,958,962],{"type":59,"value":416},{"type":54,"tag":337,"props":954,"children":955},{},[956],{"type":59,"value":519},{"type":59,"value":514},{"type":54,"tag":337,"props":959,"children":960},{},[961],{"type":59,"value":445},{"type":59,"value":357},{"type":54,"tag":294,"props":964,"children":965},{},[966,971,975],{"type":54,"tag":321,"props":967,"children":968},{},[969],{"type":59,"value":970},"hack",{"type":54,"tag":321,"props":972,"children":973},{},[974],{"type":59,"value":330},{"type":54,"tag":321,"props":976,"children":977},{},[978,980,985,986,991,993,998,999,1003],{"type":59,"value":979},"Noun: ",{"type":54,"tag":337,"props":981,"children":982},{},[983],{"type":59,"value":984},"tip",{"type":59,"value":514},{"type":54,"tag":337,"props":987,"children":988},{},[989],{"type":59,"value":990},"work-around",{"type":59,"value":992},". Verb: ",{"type":54,"tag":337,"props":994,"children":995},{},[996],{"type":59,"value":997},"configure",{"type":59,"value":514},{"type":54,"tag":337,"props":1000,"children":1001},{},[1002],{"type":59,"value":866},{"type":59,"value":357},{"type":54,"tag":294,"props":1005,"children":1006},{},[1007,1012,1016],{"type":54,"tag":321,"props":1008,"children":1009},{},[1010],{"type":59,"value":1011},"hit",{"type":54,"tag":321,"props":1013,"children":1014},{},[1015],{"type":59,"value":330},{"type":54,"tag":321,"props":1017,"children":1018},{},[1019,1020,1025,1026,1030,1031,1036],{"type":59,"value":979},{"type":54,"tag":337,"props":1021,"children":1022},{},[1023],{"type":59,"value":1024},"visits",{"type":59,"value":992},{"type":54,"tag":337,"props":1027,"children":1028},{},[1029],{"type":59,"value":606},{"type":59,"value":514},{"type":54,"tag":337,"props":1032,"children":1033},{},[1034],{"type":59,"value":1035},"press",{"type":59,"value":357},{"type":54,"tag":294,"props":1038,"children":1039},{},[1040,1045,1049],{"type":54,"tag":321,"props":1041,"children":1042},{},[1043],{"type":59,"value":1044},"i.e.",{"type":54,"tag":321,"props":1046,"children":1047},{},[1048],{"type":59,"value":330},{"type":54,"tag":321,"props":1050,"children":1051},{},[1052],{"type":59,"value":1053},"Don't use Latin abbreviations.",{"type":54,"tag":294,"props":1055,"children":1056},{},[1057,1062,1066],{"type":54,"tag":321,"props":1058,"children":1059},{},[1060],{"type":59,"value":1061},"invalid",{"type":54,"tag":321,"props":1063,"children":1064},{},[1065],{"type":59,"value":330},{"type":54,"tag":321,"props":1067,"children":1068},{},[1069,1070,1075,1076,1081],{"type":59,"value":416},{"type":54,"tag":337,"props":1071,"children":1072},{},[1073],{"type":59,"value":1074},"not valid",{"type":59,"value":514},{"type":54,"tag":337,"props":1077,"children":1078},{},[1079],{"type":59,"value":1080},"incorrect",{"type":59,"value":357},{"type":54,"tag":294,"props":1083,"children":1084},{},[1085,1090,1094],{"type":54,"tag":321,"props":1086,"children":1087},{},[1088],{"type":59,"value":1089},"kill",{"type":54,"tag":321,"props":1091,"children":1092},{},[1093],{"type":59,"value":370},{"type":54,"tag":321,"props":1095,"children":1096},{},[1097,1098,1102,1103,1107,1109,1114],{"type":59,"value":416},{"type":54,"tag":337,"props":1099,"children":1100},{},[1101],{"type":59,"value":348},{"type":59,"value":514},{"type":54,"tag":337,"props":1104,"children":1105},{},[1106],{"type":59,"value":355},{"type":59,"value":1108}," unless the actual command is ",{"type":54,"tag":72,"props":1110,"children":1112},{"className":1111},[],[1113],{"type":59,"value":1089},{"type":59,"value":357},{"type":54,"tag":294,"props":1116,"children":1117},{},[1118,1123,1127],{"type":54,"tag":321,"props":1119,"children":1120},{},[1121],{"type":59,"value":1122},"launch",{"type":54,"tag":321,"props":1124,"children":1125},{},[1126],{"type":59,"value":330},{"type":54,"tag":321,"props":1128,"children":1129},{},[1130,1131,1136],{"type":59,"value":416},{"type":54,"tag":337,"props":1132,"children":1133},{},[1134],{"type":59,"value":1135},"open",{"type":59,"value":357},{"type":54,"tag":294,"props":1138,"children":1139},{},[1140,1145,1149],{"type":54,"tag":321,"props":1141,"children":1142},{},[1143],{"type":59,"value":1144},"may",{"type":54,"tag":321,"props":1146,"children":1147},{},[1148],{"type":59,"value":370},{"type":54,"tag":321,"props":1150,"children":1151},{},[1152,1156,1158,1162,1164,1168],{"type":54,"tag":337,"props":1153,"children":1154},{},[1155],{"type":59,"value":1144},{"type":59,"value":1157}," = permissibility, ",{"type":54,"tag":337,"props":1159,"children":1160},{},[1161],{"type":59,"value":528},{"type":59,"value":1163}," = capability, ",{"type":54,"tag":337,"props":1165,"children":1166},{},[1167],{"type":59,"value":702},{"type":59,"value":1169}," = possibility.",{"type":54,"tag":294,"props":1171,"children":1172},{},[1173,1177,1181],{"type":54,"tag":321,"props":1174,"children":1175},{},[1176],{"type":59,"value":1135},{"type":54,"tag":321,"props":1178,"children":1179},{},[1180],{"type":59,"value":388},{"type":54,"tag":321,"props":1182,"children":1183},{},[1184,1186,1190],{"type":59,"value":1185},"Use instead of ",{"type":54,"tag":337,"props":1187,"children":1188},{},[1189],{"type":59,"value":1122},{"type":59,"value":357},{"type":54,"tag":294,"props":1192,"children":1193},{},[1194,1199,1203],{"type":54,"tag":321,"props":1195,"children":1196},{},[1197],{"type":59,"value":1198},"please",{"type":54,"tag":321,"props":1200,"children":1201},{},[1202],{"type":59,"value":330},{"type":54,"tag":321,"props":1204,"children":1205},{},[1206],{"type":59,"value":1207},"Unnecessary except when users must wait or face inconvenience.",{"type":54,"tag":294,"props":1209,"children":1210},{},[1211,1215,1219],{"type":54,"tag":321,"props":1212,"children":1213},{},[1214],{"type":59,"value":398},{"type":54,"tag":321,"props":1216,"children":1217},{},[1218],{"type":59,"value":388},{"type":54,"tag":321,"props":1220,"children":1221},{},[1222,1224,1228],{"type":59,"value":1223},"Removes a relationship, not data. Opposite: ",{"type":54,"tag":337,"props":1225,"children":1226},{},[1227],{"type":59,"value":383},{"type":59,"value":357},{"type":54,"tag":294,"props":1230,"children":1231},{},[1232,1236,1240],{"type":54,"tag":321,"props":1233,"children":1234},{},[1235],{"type":59,"value":597},{"type":54,"tag":321,"props":1237,"children":1238},{},[1239],{"type":59,"value":388},{"type":54,"tag":321,"props":1241,"children":1242},{},[1243,1245,1249],{"type":59,"value":1244},"Preferred over ",{"type":54,"tag":337,"props":1246,"children":1247},{},[1248],{"type":59,"value":584},{"type":59,"value":357},{"type":54,"tag":294,"props":1251,"children":1252},{},[1253,1258,1262],{"type":54,"tag":321,"props":1254,"children":1255},{},[1256],{"type":59,"value":1257},"simple, simply",{"type":54,"tag":321,"props":1259,"children":1260},{},[1261],{"type":59,"value":330},{"type":54,"tag":321,"props":1263,"children":1264},{},[1265],{"type":59,"value":1266},"Adds no value. Implies users shouldn't need help.",{"type":54,"tag":294,"props":1268,"children":1269},{},[1270,1274,1278],{"type":54,"tag":321,"props":1271,"children":1272},{},[1273],{"type":59,"value":445},{"type":54,"tag":321,"props":1275,"children":1276},{},[1277],{"type":59,"value":370},{"type":54,"tag":321,"props":1279,"children":1280},{},[1281,1282,1286],{"type":59,"value":440},{"type":54,"tag":337,"props":1283,"children":1284},{},[1285],{"type":59,"value":431},{"type":59,"value":357},{"type":54,"tag":294,"props":1288,"children":1289},{},[1290,1295,1299],{"type":54,"tag":321,"props":1291,"children":1292},{},[1293],{"type":59,"value":1294},"terminate",{"type":54,"tag":321,"props":1296,"children":1297},{},[1298],{"type":59,"value":330},{"type":54,"tag":321,"props":1300,"children":1301},{},[1302,1303,1307,1308,1313],{"type":59,"value":416},{"type":54,"tag":337,"props":1304,"children":1305},{},[1306],{"type":59,"value":355},{"type":59,"value":514},{"type":54,"tag":337,"props":1309,"children":1310},{},[1311],{"type":59,"value":1312},"exit",{"type":59,"value":357},{"type":54,"tag":294,"props":1315,"children":1316},{},[1317,1321,1325],{"type":54,"tag":321,"props":1318,"children":1319},{},[1320],{"type":59,"value":935},{"type":54,"tag":321,"props":1322,"children":1323},{},[1324],{"type":59,"value":330},{"type":54,"tag":321,"props":1326,"children":1327},{},[1328,1329,1333],{"type":59,"value":416},{"type":54,"tag":337,"props":1330,"children":1331},{},[1332],{"type":59,"value":921},{"type":59,"value":1334}," — accommodates multiple input methods.",{"type":54,"tag":294,"props":1336,"children":1337},{},[1338,1342,1346],{"type":54,"tag":321,"props":1339,"children":1340},{},[1341],{"type":59,"value":575},{"type":54,"tag":321,"props":1343,"children":1344},{},[1345],{"type":59,"value":370},{"type":54,"tag":321,"props":1347,"children":1348},{},[1349,1351,1356],{"type":59,"value":1350},"Means not being able to perform an action. Distinct from ",{"type":54,"tag":337,"props":1352,"children":1353},{},[1354],{"type":59,"value":1355},"cannot",{"type":59,"value":357},{"type":54,"tag":294,"props":1358,"children":1359},{},[1360,1365,1369],{"type":54,"tag":321,"props":1361,"children":1362},{},[1363],{"type":59,"value":1364},"utilize",{"type":54,"tag":321,"props":1366,"children":1367},{},[1368],{"type":59,"value":370},{"type":54,"tag":321,"props":1370,"children":1371},{},[1372,1373,1378],{"type":59,"value":416},{"type":54,"tag":337,"props":1374,"children":1375},{},[1376],{"type":59,"value":1377},"use",{"type":59,"value":1379}," instead.",{"type":54,"tag":294,"props":1381,"children":1382},{},[1383,1388,1392],{"type":54,"tag":321,"props":1384,"children":1385},{},[1386],{"type":59,"value":1387},"view",{"type":54,"tag":321,"props":1389,"children":1390},{},[1391],{"type":59,"value":388},{"type":54,"tag":321,"props":1393,"children":1394},{},[1395,1397,1402],{"type":59,"value":1396},"More inclusive than ",{"type":54,"tag":337,"props":1398,"children":1399},{},[1400],{"type":59,"value":1401},"see",{"type":59,"value":357},{"type":54,"tag":294,"props":1404,"children":1405},{},[1406,1411,1415],{"type":54,"tag":321,"props":1407,"children":1408},{},[1409],{"type":59,"value":1410},"whitelist",{"type":54,"tag":321,"props":1412,"children":1413},{},[1414],{"type":59,"value":330},{"type":54,"tag":321,"props":1416,"children":1417},{},[1418,1419,1424],{"type":59,"value":416},{"type":54,"tag":337,"props":1420,"children":1421},{},[1422],{"type":59,"value":1423},"allowlist",{"type":59,"value":357},{"type":54,"tag":55,"props":1426,"children":1427},{},[1428],{"type":59,"value":1429},"Also flag Latin abbreviations: replace \"e.g.\" with \"for example,\" \"i.e.\" with \"that is,\" \"etc.\" with \"and more,\" \"via\" with \"through.\"",{"type":54,"tag":192,"props":1431,"children":1433},{"id":1432},"grammar-and-spelling",[1434],{"type":59,"value":1435},"Grammar and spelling",{"type":54,"tag":199,"props":1437,"children":1438},{},[1439,1449,1459,1469,1479,1489,1499,1509],{"type":54,"tag":203,"props":1440,"children":1441},{},[1442,1447],{"type":54,"tag":207,"props":1443,"children":1444},{},[1445],{"type":59,"value":1446},"American English",{"type":59,"value":1448},": -ize\u002F-yze verbs, -or nouns, -ense nouns, -og nouns (organize, color, license, dialog).",{"type":54,"tag":203,"props":1450,"children":1451},{},[1452,1457],{"type":54,"tag":207,"props":1453,"children":1454},{},[1455],{"type":59,"value":1456},"Oxford comma",{"type":59,"value":1458},": Always use in lists of three or more.",{"type":54,"tag":203,"props":1460,"children":1461},{},[1462,1467],{"type":54,"tag":207,"props":1463,"children":1464},{},[1465],{"type":59,"value":1466},"Abbreviations",{"type":59,"value":1468},": Spell out on first use. Pluralize without apostrophes (APIs, SDKs, OSes).",{"type":54,"tag":203,"props":1470,"children":1471},{},[1472,1477],{"type":54,"tag":207,"props":1473,"children":1474},{},[1475],{"type":59,"value":1476},"Capitalization",{"type":59,"value":1478},": Sentence-style for headings. Capitalize proper nouns and product names only. Don't capitalize spelled-out acronyms unless proper nouns. Match UI capitalization.",{"type":54,"tag":203,"props":1480,"children":1481},{},[1482,1487],{"type":54,"tag":207,"props":1483,"children":1484},{},[1485],{"type":59,"value":1486},"Hyphens",{"type":59,"value":1488},": Compound adjectives before nouns (real-time results), two vowels together (re-enable), self-\u002Fex-\u002Fall- prefixes. No hyphen for predicate adjectives (\"up to date\") or adverbs ending in -ly (\"newly installed\").",{"type":54,"tag":203,"props":1490,"children":1491},{},[1492,1497],{"type":54,"tag":207,"props":1493,"children":1494},{},[1495],{"type":59,"value":1496},"Gerunds",{"type":59,"value":1498},": Use in top-level task titles. Use action verbs in lower-level titles. Avoid gerunds in prepositional phrases (\"how to configure\" not \"on configuring\").",{"type":54,"tag":203,"props":1500,"children":1501},{},[1502,1507],{"type":54,"tag":207,"props":1503,"children":1504},{},[1505],{"type":59,"value":1506},"Noun vs. verb compounds",{"type":59,"value":1508},": backup\u002Fback up, login\u002Flog in, setup\u002Fset up, startup\u002Fstart up.",{"type":54,"tag":203,"props":1510,"children":1511},{},[1512,1517,1519,1524,1526,1531,1533,1538],{"type":54,"tag":207,"props":1513,"children":1514},{},[1515],{"type":59,"value":1516},"Quotation marks",{"type":59,"value":1518},": Use double quotation marks to quote error messages or introduce an unfamiliar term on first use only. Do ",{"type":54,"tag":207,"props":1520,"children":1521},{},[1522],{"type":59,"value":1523},"not",{"type":59,"value":1525}," use quotation marks for code\u002Fcommands (use monospace instead), for emphasis (use bold or italic), or for product\u002Ffeature\u002FUI names. Place commas and periods ",{"type":54,"tag":207,"props":1527,"children":1528},{},[1529],{"type":59,"value":1530},"inside",{"type":59,"value":1532}," closing quotation marks. Place colons, semicolons, question marks, and exclamation points ",{"type":54,"tag":207,"props":1534,"children":1535},{},[1536],{"type":59,"value":1537},"outside",{"type":59,"value":1539}," closing quotation marks (unless part of the quoted material). Use single quotation marks only for quotations within quotations.",{"type":54,"tag":192,"props":1541,"children":1543},{"id":1542},"formatting",[1544],{"type":59,"value":1545},"Formatting",{"type":54,"tag":199,"props":1547,"children":1548},{},[1549,1559,1569,1579,1589,1623,1633,1643,1653,1663,1673],{"type":54,"tag":203,"props":1550,"children":1551},{},[1552,1557],{"type":54,"tag":207,"props":1553,"children":1554},{},[1555],{"type":59,"value":1556},"Bold",{"type":59,"value":1558},": UI element names (apps, buttons, menu items, page names, tabs, columns).",{"type":54,"tag":203,"props":1560,"children":1561},{},[1562,1567],{"type":54,"tag":207,"props":1563,"children":1564},{},[1565],{"type":59,"value":1566},"Italic",{"type":59,"value":1568},": New terms and concepts, Elastic documentation resource titles.",{"type":54,"tag":203,"props":1570,"children":1571},{},[1572,1577],{"type":54,"tag":207,"props":1573,"children":1574},{},[1575],{"type":59,"value":1576},"Monospace",{"type":59,"value":1578},": API endpoints, class names, code, commands, config settings, data types, directories, env vars, error messages, field names, function names, index names, parameters, process names, property names, role names, variables.",{"type":54,"tag":203,"props":1580,"children":1581},{},[1582,1587],{"type":54,"tag":207,"props":1583,"children":1584},{},[1585],{"type":59,"value":1586},"Numbers",{"type":59,"value":1588},": Write out 1–9 in prose, numerals for 10+. Use numerals in tables, for decimals, dimensions, percentages. Separate large numbers with commas (1,234,567).",{"type":54,"tag":203,"props":1590,"children":1591},{},[1592,1597,1599,1605,1607,1613,1615,1621],{"type":54,"tag":207,"props":1593,"children":1594},{},[1595],{"type":59,"value":1596},"Dates and times",{"type":59,"value":1598},": Use ",{"type":54,"tag":72,"props":1600,"children":1602},{"className":1601},[],[1603],{"type":59,"value":1604},"Month DD, YYYY",{"type":59,"value":1606}," for dates. Use 12-hour time with uppercase ",{"type":54,"tag":72,"props":1608,"children":1610},{"className":1609},[],[1611],{"type":59,"value":1612},"AM",{"type":59,"value":1614},"\u002F",{"type":54,"tag":72,"props":1616,"children":1618},{"className":1617},[],[1619],{"type":59,"value":1620},"PM",{"type":59,"value":1622},". Use UTC as the primary time zone, or include UTC with local time when needed. Avoid relative terms such as \"last month,\" \"recently,\" and \"currently.\"",{"type":54,"tag":203,"props":1624,"children":1625},{},[1626,1631],{"type":54,"tag":207,"props":1627,"children":1628},{},[1629],{"type":59,"value":1630},"Lists",{"type":59,"value":1632},": Minimum two items. Parallel structure. Capitalize first letter. No periods unless complete sentences. Introduce with a heading, sentence, or fragment ending with a colon.",{"type":54,"tag":203,"props":1634,"children":1635},{},[1636,1641],{"type":54,"tag":207,"props":1637,"children":1638},{},[1639],{"type":59,"value":1640},"Paragraphs",{"type":59,"value":1642},": Keep under seven lines.",{"type":54,"tag":203,"props":1644,"children":1645},{},[1646,1651],{"type":54,"tag":207,"props":1647,"children":1648},{},[1649],{"type":59,"value":1650},"Line spacing",{"type":59,"value":1652},": Single line break between elements.",{"type":54,"tag":203,"props":1654,"children":1655},{},[1656,1661],{"type":54,"tag":207,"props":1657,"children":1658},{},[1659],{"type":59,"value":1660},"Admonitions",{"type":59,"value":1662},": Use notes, tips, warnings, important blocks, and plain admonitions for their documented purpose. Do not stack admonitions, overuse them, or use regular admonitions for prerequisites when a plain requirements admonition fits better.",{"type":54,"tag":203,"props":1664,"children":1665},{},[1666,1671],{"type":54,"tag":207,"props":1667,"children":1668},{},[1669],{"type":59,"value":1670},"Code samples",{"type":59,"value":1672},": Use consistent indentation, syntax highlighting, runnable examples when possible, and short comments before the code they explain. For JSON, use footnotes only when needed because footnotes are less accessible.",{"type":54,"tag":203,"props":1674,"children":1675},{},[1676,1681],{"type":54,"tag":207,"props":1677,"children":1678},{},[1679],{"type":59,"value":1680},"Sensitive information",{"type":59,"value":1682},": Flag screenshots, examples, logs, tokens, hostnames, IPs, internal links, customer data, and secrets that need redaction or replacement with documentation-safe placeholders.",{"type":54,"tag":192,"props":1684,"children":1685},{"id":14},[1686],{"type":59,"value":13},{"type":54,"tag":199,"props":1688,"children":1689},{},[1690,1700,1710,1720,1730,1740,1750],{"type":54,"tag":203,"props":1691,"children":1692},{},[1693,1698],{"type":54,"tag":207,"props":1694,"children":1695},{},[1696],{"type":59,"value":1697},"Alt text",{"type":59,"value":1699},": Required for all images, icons, and media. No backticks in alt text.",{"type":54,"tag":203,"props":1701,"children":1702},{},[1703,1708],{"type":54,"tag":207,"props":1704,"children":1705},{},[1706],{"type":59,"value":1707},"Link text",{"type":59,"value":1709},": Descriptive — never \"click here\" or bare URLs.",{"type":54,"tag":203,"props":1711,"children":1712},{},[1713,1718],{"type":54,"tag":207,"props":1714,"children":1715},{},[1716],{"type":59,"value":1717},"No directional language",{"type":59,"value":1719},": Avoid \"above,\" \"below,\" \"left,\" \"right\" for positional references.",{"type":54,"tag":203,"props":1721,"children":1722},{},[1723,1728],{"type":54,"tag":207,"props":1724,"children":1725},{},[1726],{"type":59,"value":1727},"Device-neutral verbs",{"type":59,"value":1729},": Prefer device-neutral language. Use \"select\" for choices — tabs, checkboxes, dropdowns, and radio buttons. Use \"click\" for button actions, icons, and following links. Avoid \"click\" when the user is making a selection rather than triggering an action.",{"type":54,"tag":203,"props":1731,"children":1732},{},[1733,1738],{"type":54,"tag":207,"props":1734,"children":1735},{},[1736],{"type":59,"value":1737},"Plain language",{"type":59,"value":1739},": Short sentences. Expand acronyms on first use. Parallel structures in lists.",{"type":54,"tag":203,"props":1741,"children":1742},{},[1743,1748],{"type":54,"tag":207,"props":1744,"children":1745},{},[1746],{"type":59,"value":1747},"Gender-neutral",{"type":59,"value":1749},": Use they\u002Ftheir. Replace gendered defaults (use \"folks\" not \"guys\").",{"type":54,"tag":203,"props":1751,"children":1752},{},[1753,1757],{"type":54,"tag":207,"props":1754,"children":1755},{},[1756],{"type":59,"value":330},{"type":59,"value":1758},": Buzzwords, superhero terms, violent imagery, ableist language, non-specific superlatives.",{"type":54,"tag":192,"props":1760,"children":1762},{"id":1761},"ui-writing",[1763],{"type":59,"value":1764},"UI writing",{"type":54,"tag":199,"props":1766,"children":1767},{},[1768,1785,1809,1890,1914,1944,1954,1977,1987,1997,2007,2017,2054],{"type":54,"tag":203,"props":1769,"children":1770},{},[1771,1776,1778,1783],{"type":54,"tag":207,"props":1772,"children":1773},{},[1774],{"type":59,"value":1775},"Buttons",{"type":59,"value":1777},": \"Click ",{"type":54,"tag":207,"props":1779,"children":1780},{},[1781],{"type":59,"value":1782},"Save",{"type":59,"value":1784},"\" — don't add \"button\" after the label.",{"type":54,"tag":203,"props":1786,"children":1787},{},[1788,1793,1795,1800,1802,1807],{"type":54,"tag":207,"props":1789,"children":1790},{},[1791],{"type":59,"value":1792},"Checkboxes\u002Fradio buttons",{"type":59,"value":1794},": \"Select ",{"type":54,"tag":207,"props":1796,"children":1797},{},[1798],{"type":59,"value":1799},"Logs",{"type":59,"value":1801},"\" \u002F \"Clear ",{"type":54,"tag":207,"props":1803,"children":1804},{},[1805],{"type":59,"value":1806},"Metrics",{"type":59,"value":1808},".\"",{"type":54,"tag":203,"props":1810,"children":1811},{},[1812,1817,1818,1823,1825,1829,1831,1836,1838,1843,1845,1849,1851,1856,1858,1862,1864,1868,1870,1874,1876,1882,1884,1888],{"type":54,"tag":207,"props":1813,"children":1814},{},[1815],{"type":59,"value":1816},"Select vs. click",{"type":59,"value":1598},{"type":54,"tag":207,"props":1819,"children":1820},{},[1821],{"type":59,"value":1822},"\"click\"",{"type":59,"value":1824}," when a user is initiating a process, performing a command, following a link, or physically activating a button or icon (e.g., \"Click ",{"type":54,"tag":207,"props":1826,"children":1827},{},[1828],{"type":59,"value":1782},{"type":59,"value":1830},"\", \"Click the ",{"type":54,"tag":207,"props":1832,"children":1833},{},[1834],{"type":59,"value":1835},"Help",{"type":59,"value":1837}," icon\"). Use ",{"type":54,"tag":207,"props":1839,"children":1840},{},[1841],{"type":59,"value":1842},"\"select\"",{"type":59,"value":1844}," when a user is making a choice — picking from a dropdown, toggling a checkbox, choosing a tab, or picking from a set (e.g., \"Select the ",{"type":54,"tag":207,"props":1846,"children":1847},{},[1848],{"type":59,"value":1799},{"type":59,"value":1850}," tab\", \"Select the ",{"type":54,"tag":207,"props":1852,"children":1853},{},[1854],{"type":59,"value":1855},"Enforce HTTPS",{"type":59,"value":1857}," checkbox\"). ❌ \"Select the ",{"type":54,"tag":207,"props":1859,"children":1860},{},[1861],{"type":59,"value":1782},{"type":59,"value":1863}," button to confirm your changes\" \u002F ✅ \"Click ",{"type":54,"tag":207,"props":1865,"children":1866},{},[1867],{"type":59,"value":1782},{"type":59,"value":1869}," to confirm your changes\". ❌ \"Click ",{"type":54,"tag":207,"props":1871,"children":1872},{},[1873],{"type":59,"value":1799},{"type":59,"value":1875},"\" ",{"type":54,"tag":1877,"props":1878,"children":1879},"span",{},[1880],{"type":59,"value":1881},"for a tab",{"type":59,"value":1883}," \u002F ✅ \"Select the ",{"type":54,"tag":207,"props":1885,"children":1886},{},[1887],{"type":59,"value":1799},{"type":59,"value":1889}," tab to view events\".",{"type":54,"tag":203,"props":1891,"children":1892},{},[1893,1898,1900,1905,1907,1913],{"type":54,"tag":207,"props":1894,"children":1895},{},[1896],{"type":59,"value":1897},"Text fields",{"type":59,"value":1899},": \"In the ",{"type":54,"tag":207,"props":1901,"children":1902},{},[1903],{"type":59,"value":1904},"Name",{"type":59,"value":1906}," field, enter ",{"type":54,"tag":72,"props":1908,"children":1910},{"className":1909},[],[1911],{"type":59,"value":1912},"value",{"type":59,"value":1808},{"type":54,"tag":203,"props":1915,"children":1916},{},[1917,1922,1924,1929,1931,1935,1937,1942],{"type":54,"tag":207,"props":1918,"children":1919},{},[1920],{"type":59,"value":1921},"Toggles",{"type":59,"value":1923},": \"Turn on ",{"type":54,"tag":207,"props":1925,"children":1926},{},[1927],{"type":59,"value":1928},"Feature",{"type":59,"value":1930},"\" \u002F \"Turn off ",{"type":54,"tag":207,"props":1932,"children":1933},{},[1934],{"type":59,"value":1928},{"type":59,"value":1936},"\" — not \"enable\u002Fdisable\" as verbs. Use \"toggle\" as a ",{"type":54,"tag":207,"props":1938,"children":1939},{},[1940],{"type":59,"value":1941},"noun",{"type":59,"value":1943}," to refer to the UI element (e.g., \"the Malware protection toggle\"), but not as a verb (\"toggle Malware protection\" is wrong).",{"type":54,"tag":203,"props":1945,"children":1946},{},[1947,1952],{"type":54,"tag":207,"props":1948,"children":1949},{},[1950],{"type":59,"value":1951},"Keys",{"type":59,"value":1953},": \"Press Enter\" \u002F \"Press Command+Alt+L.\"",{"type":54,"tag":203,"props":1955,"children":1956},{},[1957,1962,1964,1969,1971,1975],{"type":54,"tag":207,"props":1958,"children":1959},{},[1960],{"type":59,"value":1961},"Menus",{"type":59,"value":1963},": Use arrows for navigation — \"Select ",{"type":54,"tag":207,"props":1965,"children":1966},{},[1967],{"type":59,"value":1968},"Manage index → Add lifecycle policy",{"type":59,"value":1970},".\" Do ",{"type":54,"tag":207,"props":1972,"children":1973},{},[1974],{"type":59,"value":1523},{"type":59,"value":1976}," use the verbs \"open\" or \"close\" for menus; use \"From the menu,...\" instead. Refer to the element as \"menu\" — not \"dropdown menu\" or \"dropdown list.\"",{"type":54,"tag":203,"props":1978,"children":1979},{},[1980,1985],{"type":54,"tag":207,"props":1981,"children":1982},{},[1983],{"type":59,"value":1984},"Icons",{"type":59,"value":1986},": Reference by tooltip text, include inline icon. Avoid parentheses around icons.",{"type":54,"tag":203,"props":1988,"children":1989},{},[1990,1995],{"type":54,"tag":207,"props":1991,"children":1992},{},[1993],{"type":59,"value":1994},"Screenshots",{"type":59,"value":1996},": Use screenshots sparingly for complex UI, introductions, or timebound content. Check that screenshots use a consistent aspect ratio, 100% zoom, only essential UI, a screenshot border when appropriate, accessible alt text, and no sensitive information.",{"type":54,"tag":203,"props":1998,"children":1999},{},[2000,2005],{"type":54,"tag":207,"props":2001,"children":2002},{},[2003],{"type":59,"value":2004},"Procedures",{"type":59,"value":2006},": 5–9 steps. Focus on use cases, not piece-by-piece UI description. Eliminate obvious steps.",{"type":54,"tag":203,"props":2008,"children":2009},{},[2010,2015],{"type":54,"tag":207,"props":2011,"children":2012},{},[2013],{"type":59,"value":2014},"Prepositions",{"type":59,"value":2016},": \"in\" a field\u002Fwindow\u002Fmenu, \"on\" a page\u002Ftab, \"from\" a list\u002Fcommand line, \"at\" the command prompt.",{"type":54,"tag":203,"props":2018,"children":2019},{},[2020,2025,2027,2032,2034,2039,2041,2045,2047,2052],{"type":54,"tag":207,"props":2021,"children":2022},{},[2023],{"type":59,"value":2024},"Referring to apps and pages",{"type":59,"value":2026},": In Kibana, navigation can vary by environment. Use solution-agnostic patterns when directing users to apps or pages: \"Find ",{"type":54,"tag":207,"props":2028,"children":2029},{},[2030],{"type":59,"value":2031},"APP",{"type":59,"value":2033}," in the navigation menu or use the ",{"type":54,"tag":1877,"props":2035,"children":2036},{},[2037],{"type":59,"value":2038},"global search field",{"type":59,"value":2040},".\" When the app is only reachable via search: \"To open ",{"type":54,"tag":207,"props":2042,"children":2043},{},[2044],{"type":59,"value":2031},{"type":59,"value":2046},", find ",{"type":54,"tag":207,"props":2048,"children":2049},{},[2050],{"type":59,"value":2051},"PARENT",{"type":59,"value":2053}," in the navigation menu or use the global search field.\" Flag instructions that assume a fixed navigation path without offering the search alternative.",{"type":54,"tag":203,"props":2055,"children":2056},{},[2057,2062,2064],{"type":54,"tag":207,"props":2058,"children":2059},{},[2060],{"type":59,"value":2061},"Naming Kibana UI elements",{"type":59,"value":2063},": Use the canonical names for parts of the Kibana chrome. Flag any other variants you see.",{"type":54,"tag":286,"props":2065,"children":2066},{},[2067,2088],{"type":54,"tag":290,"props":2068,"children":2069},{},[2070],{"type":54,"tag":294,"props":2071,"children":2072},{},[2073,2078,2083],{"type":54,"tag":298,"props":2074,"children":2075},{},[2076],{"type":59,"value":2077},"Term",{"type":54,"tag":298,"props":2079,"children":2080},{},[2081],{"type":59,"value":2082},"What it refers to",{"type":54,"tag":298,"props":2084,"children":2085},{},[2086],{"type":59,"value":2087},"Variants to flag",{"type":54,"tag":314,"props":2089,"children":2090},{},[2091,2112,2133,2154,2181,2202,2223,2244,2265],{"type":54,"tag":294,"props":2092,"children":2093},{},[2094,2102,2107],{"type":54,"tag":321,"props":2095,"children":2096},{},[2097],{"type":54,"tag":207,"props":2098,"children":2099},{},[2100],{"type":59,"value":2101},"Global header",{"type":54,"tag":321,"props":2103,"children":2104},{},[2105],{"type":59,"value":2106},"The top bar of the Kibana chrome that hosts global controls.",{"type":54,"tag":321,"props":2108,"children":2109},{},[2110],{"type":59,"value":2111},"\"Kibana header\" alone",{"type":54,"tag":294,"props":2113,"children":2114},{},[2115,2123,2128],{"type":54,"tag":321,"props":2116,"children":2117},{},[2118],{"type":54,"tag":207,"props":2119,"children":2120},{},[2121],{"type":59,"value":2122},"Navigation menu",{"type":54,"tag":321,"props":2124,"children":2125},{},[2126],{"type":59,"value":2127},"The primary navigation panel on the left side of Kibana.",{"type":54,"tag":321,"props":2129,"children":2130},{},[2131],{"type":59,"value":2132},"\"main menu\", \"side navigation\", \"side nav\", \"sidenav\", \"navbar\", \"primary navigation\"",{"type":54,"tag":294,"props":2134,"children":2135},{},[2136,2144,2149],{"type":54,"tag":321,"props":2137,"children":2138},{},[2139],{"type":54,"tag":207,"props":2140,"children":2141},{},[2142],{"type":59,"value":2143},"Solution view",{"type":54,"tag":321,"props":2145,"children":2146},{},[2147],{"type":59,"value":2148},"The per-space setting that controls the navigation menu.",{"type":54,"tag":321,"props":2150,"children":2151},{},[2152],{"type":59,"value":2153},"—",{"type":54,"tag":294,"props":2155,"children":2156},{},[2157,2165,2176],{"type":54,"tag":321,"props":2158,"children":2159},{},[2160],{"type":54,"tag":207,"props":2161,"children":2162},{},[2163],{"type":59,"value":2164},"Classic view",{"type":54,"tag":321,"props":2166,"children":2167},{},[2168,2170,2174],{"type":59,"value":2169},"The non-solution option in the ",{"type":54,"tag":207,"props":2171,"children":2172},{},[2173],{"type":59,"value":2143},{"type":59,"value":2175}," setting.",{"type":54,"tag":321,"props":2177,"children":2178},{},[2179],{"type":59,"value":2180},"\"Classic navigation\", bare \"Classic\" when ambiguous with Discover's Classic mode",{"type":54,"tag":294,"props":2182,"children":2183},{},[2184,2192,2197],{"type":54,"tag":321,"props":2185,"children":2186},{},[2187],{"type":54,"tag":207,"props":2188,"children":2189},{},[2190],{"type":59,"value":2191},"Secondary navigation",{"type":54,"tag":321,"props":2193,"children":2194},{},[2195],{"type":59,"value":2196},"The panel that opens next to the navigation menu for nested items.",{"type":54,"tag":321,"props":2198,"children":2199},{},[2200],{"type":59,"value":2201},"\"secondary nav menu\", \"secondary nav panel\" alone",{"type":54,"tag":294,"props":2203,"children":2204},{},[2205,2213,2218],{"type":54,"tag":321,"props":2206,"children":2207},{},[2208],{"type":54,"tag":207,"props":2209,"children":2210},{},[2211],{"type":59,"value":2212},"Application menu",{"type":54,"tag":321,"props":2214,"children":2215},{},[2216],{"type":59,"value":2217},"The bar above the workspace that hosts app-specific actions.",{"type":54,"tag":321,"props":2219,"children":2220},{},[2221],{"type":59,"value":2222},"\"App menu bar\", \"app menu\"",{"type":54,"tag":294,"props":2224,"children":2225},{},[2226,2234,2239],{"type":54,"tag":321,"props":2227,"children":2228},{},[2229],{"type":54,"tag":207,"props":2230,"children":2231},{},[2232],{"type":59,"value":2233},"Workspace",{"type":54,"tag":321,"props":2235,"children":2236},{},[2237],{"type":59,"value":2238},"The main content area of the current app.",{"type":54,"tag":321,"props":2240,"children":2241},{},[2242],{"type":59,"value":2243},"\"App workspace\"",{"type":54,"tag":294,"props":2245,"children":2246},{},[2247,2255,2260],{"type":54,"tag":321,"props":2248,"children":2249},{},[2250],{"type":54,"tag":207,"props":2251,"children":2252},{},[2253],{"type":59,"value":2254},"Flyout",{"type":54,"tag":321,"props":2256,"children":2257},{},[2258],{"type":59,"value":2259},"A panel that slides in from the right of the workspace.",{"type":54,"tag":321,"props":2261,"children":2262},{},[2263],{"type":59,"value":2264},"\"flyout session\", \"grouped flyout\" (these are internal terms)",{"type":54,"tag":294,"props":2266,"children":2267},{},[2268,2276,2281],{"type":54,"tag":321,"props":2269,"children":2270},{},[2271],{"type":54,"tag":207,"props":2272,"children":2273},{},[2274],{"type":59,"value":2275},"Sidebar",{"type":54,"tag":321,"props":2277,"children":2278},{},[2279],{"type":59,"value":2280},"The global, resizable right-hand panel where plugins register apps.",{"type":54,"tag":321,"props":2282,"children":2283},{},[2284],{"type":59,"value":2153},{"type":54,"tag":55,"props":2286,"children":2287},{},[2288,2290,2295,2297,2302],{"type":59,"value":2289},"When a generic word-choice rule conflicts with UI writing, prefer the UI-specific rule. For example, ",{"type":54,"tag":72,"props":2291,"children":2293},{"className":2292},[],[2294],{"type":59,"value":606},{"type":59,"value":2296}," is correct for action buttons and icons, while ",{"type":54,"tag":72,"props":2298,"children":2300},{"className":2299},[],[2301],{"type":59,"value":597},{"type":59,"value":2303}," is correct for choices such as tabs, checkboxes, radio buttons, and dropdown options.",{"type":54,"tag":188,"props":2305,"children":2306},{},[],{"type":54,"tag":62,"props":2308,"children":2310},{"id":2309},"step-5-generate-the-report",[2311],{"type":59,"value":2312},"Step 5: Generate the report",{"type":54,"tag":55,"props":2314,"children":2315},{},[2316],{"type":59,"value":2317},"Present findings as a structured report. Group issues by area. For each issue:",{"type":54,"tag":2319,"props":2320,"children":2321},"ol",{},[2322,2338,2348,2358],{"type":54,"tag":203,"props":2323,"children":2324},{},[2325,2330,2332],{"type":54,"tag":207,"props":2326,"children":2327},{},[2328],{"type":59,"value":2329},"File and line",{"type":59,"value":2331}," — ",{"type":54,"tag":72,"props":2333,"children":2335},{"className":2334},[],[2336],{"type":59,"value":2337},"path\u002Fto\u002Ffile.md:42",{"type":54,"tag":203,"props":2339,"children":2340},{},[2341,2346],{"type":54,"tag":207,"props":2342,"children":2343},{},[2344],{"type":59,"value":2345},"Area",{"type":59,"value":2347}," — one of: Voice\u002FTone, Word Choice, Grammar\u002FSpelling, Formatting, Accessibility, UI Writing",{"type":54,"tag":203,"props":2349,"children":2350},{},[2351,2356],{"type":54,"tag":207,"props":2352,"children":2353},{},[2354],{"type":59,"value":2355},"Issue",{"type":59,"value":2357}," — what's wrong",{"type":54,"tag":203,"props":2359,"children":2360},{},[2361,2366],{"type":54,"tag":207,"props":2362,"children":2363},{},[2364],{"type":59,"value":2365},"Suggestion",{"type":59,"value":2367}," — how to fix it",{"type":54,"tag":192,"props":2369,"children":2371},{"id":2370},"report-format",[2372],{"type":59,"value":2373},"Report format",{"type":54,"tag":135,"props":2375,"children":2378},{"className":2376,"code":2377,"language":59},[138],"## Style review: \u003Cfile or directory>\n\n### Summary\n- X issues found (Y from Vale, Z from manual review)\n- Breakdown by area: ...\n\n### Issues\n\n#### Voice and tone\n- `file.md:12` — Passive voice: \"Settings can be configured...\" → \"You can configure settings...\"\n\n#### Word choice\n- `file.md:25` — Avoid \"click\" for device-neutral context → use \"select\"\n- `file.md:30` — Latin abbreviation \"e.g.\" → \"for example\"\n\n...\n",[2379],{"type":54,"tag":72,"props":2380,"children":2381},{"__ignoreMap":143},[2382],{"type":59,"value":2377},{"type":54,"tag":55,"props":2384,"children":2385},{},[2386],{"type":59,"value":2387},"If no issues are found, say so. Always end with a one-line summary.",{"type":54,"tag":62,"props":2389,"children":2391},{"id":2390},"style-guide-reference",[2392],{"type":59,"value":2393},"Style guide reference",{"type":54,"tag":55,"props":2395,"children":2396},{},[2397],{"type":59,"value":2398},"For deeper investigation, consult these pages:",{"type":54,"tag":199,"props":2400,"children":2401},{},[2402,2413,2421,2429,2437,2445,2453],{"type":54,"tag":203,"props":2403,"children":2404},{},[2405],{"type":54,"tag":2406,"props":2407,"children":2410},"a",{"href":43,"rel":2408},[2409],"nofollow",[2411],{"type":59,"value":2412},"Style guide overview",{"type":54,"tag":203,"props":2414,"children":2415},{},[2416],{"type":54,"tag":2406,"props":2417,"children":2419},{"href":44,"rel":2418},[2409],[2420],{"type":59,"value":197},{"type":54,"tag":203,"props":2422,"children":2423},{},[2424],{"type":54,"tag":2406,"props":2425,"children":2427},{"href":45,"rel":2426},[2409],[2428],{"type":59,"value":13},{"type":54,"tag":203,"props":2430,"children":2431},{},[2432],{"type":54,"tag":2406,"props":2433,"children":2435},{"href":46,"rel":2434},[2409],[2436],{"type":59,"value":1435},{"type":54,"tag":203,"props":2438,"children":2439},{},[2440],{"type":54,"tag":2406,"props":2441,"children":2443},{"href":47,"rel":2442},[2409],[2444],{"type":59,"value":279},{"type":54,"tag":203,"props":2446,"children":2447},{},[2448],{"type":54,"tag":2406,"props":2449,"children":2451},{"href":48,"rel":2450},[2409],[2452],{"type":59,"value":1545},{"type":54,"tag":203,"props":2454,"children":2455},{},[2456],{"type":54,"tag":2406,"props":2457,"children":2459},{"href":49,"rel":2458},[2409],[2460],{"type":59,"value":1764},{"items":2462,"total":2633},[2463,2482,2499,2514,2533,2545,2555,2570,2582,2596,2607,2620],{"slug":2464,"name":2464,"fn":2465,"description":2466,"org":2467,"tags":2468,"stars":2479,"repoUrl":2480,"updatedAt":2481},"accessing-benchmark-results","retrieve and analyze Rally benchmark results","Retrieve Rally benchmark results from an external Elasticsearch metrics store. Use to list past races, get a single race's overall (per-task) results, chart a metric's trend across multiple runs, compare two races, or check whether a run converged — e.g. \"show me recent geonames races\", \"what's the service_time trend for nyc_taxis over the last 30 days?\", \"compare these two race-ids\". Applies when datastore.type = elasticsearch is set in ~\u002F.rally\u002Frally.ini.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2469,2472,2475,2476],{"name":2470,"slug":2471,"type":15},"Analytics","analytics",{"name":2473,"slug":2474,"type":15},"Data Analysis","data-analysis",{"name":9,"slug":8,"type":15},{"name":2477,"slug":2478,"type":15},"Performance","performance",2027,"https:\u002F\u002Fgithub.com\u002Felastic\u002Frally","2026-07-12T07:46:38.54144",{"slug":2483,"name":2483,"fn":2484,"description":2485,"org":2486,"tags":2487,"stars":2479,"repoUrl":2480,"updatedAt":2498},"developing-rally","develop and debug Rally source code","Work on Rally's own codebase, not running benchmarks with it. Use when setting up the dev environment, running Rally's tests or linters, navigating its source, debugging Rally's own code, or making changes to Rally itself.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2488,2491,2492,2495],{"name":2489,"slug":2490,"type":15},"Debugging","debugging",{"name":9,"slug":8,"type":15},{"name":2493,"slug":2494,"type":15},"Engineering","engineering",{"name":2496,"slug":2497,"type":15},"Local Development","local-development","2026-07-12T07:46:35.976807",{"slug":2500,"name":2500,"fn":2501,"description":2502,"org":2503,"tags":2504,"stars":2479,"repoUrl":2480,"updatedAt":2513},"running-benchmarks","run Rally benchmarks against Elasticsearch","Run Rally benchmarks (races) against Elasticsearch — an existing\u002Fexternal cluster or a Rally-provisioned distribution — and read the summary report. Use when running a race (any pipeline, track, challenge, target-hosts, or auth) or when interpreting throughput, latency, and service_time results.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2505,2506,2509,2510],{"name":9,"slug":8,"type":15},{"name":2507,"slug":2508,"type":15},"Elasticsearch","elasticsearch",{"name":2477,"slug":2478,"type":15},{"name":2511,"slug":2512,"type":15},"Testing","testing","2026-07-12T07:46:37.277964",{"slug":2515,"name":2515,"fn":2516,"description":2517,"org":2518,"tags":2519,"stars":2530,"repoUrl":2531,"updatedAt":2532},"cloud-access-management","manage Elastic Cloud organization access","Manage Elastic Cloud organization access: invite users, assign roles to Serverless projects, and create or revoke Cloud API keys. Use when granting, modifying, or auditing user access.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2520,2523,2524,2527],{"name":2521,"slug":2522,"type":15},"Cloud","cloud",{"name":9,"slug":8,"type":15},{"name":2525,"slug":2526,"type":15},"Operations","operations",{"name":2528,"slug":2529,"type":15},"Permissions","permissions",531,"https:\u002F\u002Fgithub.com\u002Felastic\u002Fagent-skills","2026-07-12T07:46:44.946285",{"slug":2534,"name":2534,"fn":2535,"description":2536,"org":2537,"tags":2538,"stars":2530,"repoUrl":2531,"updatedAt":2544},"cloud-create-project","create Elastic Cloud Serverless projects","Creates Elastic Cloud Serverless projects (Elasticsearch, Observability, or Security) via the REST API, saves credentials to file, and bootstraps a scoped Elasticsearch API key. Use when creating a new serverless project, provisioning a search or observability environment, or spinning up a new Elastic Cloud project.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2539,2540,2543],{"name":2521,"slug":2522,"type":15},{"name":2541,"slug":2542,"type":15},"Deployment","deployment",{"name":2507,"slug":2508,"type":15},"2026-07-12T07:46:42.353362",{"slug":2546,"name":2546,"fn":2547,"description":2548,"org":2549,"tags":2550,"stars":2530,"repoUrl":2531,"updatedAt":2554},"cloud-manage-project","manage Elastic Cloud Serverless projects","Manages existing Elastic Cloud Serverless projects: list, get, update, delete, reset credentials, resume, and load saved credentials. Connects to existing projects by resolving endpoints and acquiring scoped Elasticsearch API keys. Use when performing day-2 operations on serverless projects, connecting to an existing project, loading or resetting project credentials, or looking up project details.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2551,2552,2553],{"name":2521,"slug":2522,"type":15},{"name":2507,"slug":2508,"type":15},{"name":2525,"slug":2526,"type":15},"2026-07-12T07:46:41.097412",{"slug":2556,"name":2556,"fn":2557,"description":2558,"org":2559,"tags":2560,"stars":2530,"repoUrl":2531,"updatedAt":2569},"cloud-network-security","manage Elastic Cloud network security","Manage Serverless network security (traffic filters): create, update, and delete IP filters and AWS PrivateLink VPC filters. Use when restricting network access or configuring private connectivity.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2561,2562,2563,2566],{"name":2521,"slug":2522,"type":15},{"name":2507,"slug":2508,"type":15},{"name":2564,"slug":2565,"type":15},"Networking","networking",{"name":2567,"slug":2568,"type":15},"Security","security","2026-07-12T07:46:43.675992",{"slug":2571,"name":2571,"fn":2572,"description":2573,"org":2574,"tags":2575,"stars":2530,"repoUrl":2531,"updatedAt":2581},"cloud-setup","configure Elastic Cloud authentication","Configures Elastic Cloud authentication and environment defaults. Use when setting up EC_API_KEY, configuring Cloud API access, or when another cloud skill requires credentials.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2576,2579,2580],{"name":2577,"slug":2578,"type":15},"Authentication","authentication",{"name":2521,"slug":2522,"type":15},{"name":2507,"slug":2508,"type":15},"2026-07-12T07:46:39.783105",{"slug":2583,"name":2583,"fn":2584,"description":2585,"org":2586,"tags":2587,"stars":2530,"repoUrl":2531,"updatedAt":2595},"elasticsearch-audit","configure Elasticsearch security audit logs","Enable, configure, and query Elasticsearch security audit logs. Use when the task involves audit logging setup, event filtering, or investigating security incidents like failed logins.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2588,2591,2592,2594],{"name":2589,"slug":2590,"type":15},"Audit","audit",{"name":2507,"slug":2508,"type":15},{"name":1799,"slug":2593,"type":15},"logs",{"name":2567,"slug":2568,"type":15},"2026-07-12T07:47:35.092599",{"slug":2597,"name":2597,"fn":2598,"description":2599,"org":2600,"tags":2601,"stars":2530,"repoUrl":2531,"updatedAt":2606},"elasticsearch-authn","configure Elasticsearch authentication realms","Authenticate to Elasticsearch using native, file-based, LDAP\u002FAD, SAML, OIDC, Kerberos, JWT, or certificate realms. Use when connecting with credentials, choosing a realm, or managing API keys. Assumes the target realms are already configured.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2602,2603,2604,2605],{"name":2577,"slug":2578,"type":15},{"name":9,"slug":8,"type":15},{"name":2507,"slug":2508,"type":15},{"name":2567,"slug":2568,"type":15},"2026-07-12T07:47:41.474547",{"slug":2608,"name":2608,"fn":2609,"description":2610,"org":2611,"tags":2612,"stars":2530,"repoUrl":2531,"updatedAt":2619},"elasticsearch-authz","manage Elasticsearch RBAC and security roles","Manage Elasticsearch RBAC: native users, roles, role mappings, document- and field-level security. Use when creating users or roles, assigning privileges, or mapping external realms like LDAP\u002FSAML.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2613,2614,2615,2618],{"name":9,"slug":8,"type":15},{"name":2507,"slug":2508,"type":15},{"name":2616,"slug":2617,"type":15},"RBAC","rbac",{"name":2567,"slug":2568,"type":15},"2026-07-12T07:47:36.394177",{"slug":2621,"name":2621,"fn":2622,"description":2623,"org":2624,"tags":2625,"stars":2530,"repoUrl":2531,"updatedAt":2632},"elasticsearch-esql","query Elasticsearch data with ES|QL","Execute ES|QL (Elasticsearch Query Language) queries, use when the user wants to query Elasticsearch data, analyze logs, aggregate metrics, explore data, or create charts and dashboards from ES|QL results.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2626,2627,2628,2629],{"name":2470,"slug":2471,"type":15},{"name":2473,"slug":2474,"type":15},{"name":2507,"slug":2508,"type":15},{"name":2630,"slug":2631,"type":15},"SQL","sql","2026-07-12T07:47:40.249533",86,{"items":2635,"total":2706},[2636,2646,2653,2663,2672,2685,2695],{"slug":2637,"name":2637,"fn":2638,"description":2639,"org":2640,"tags":2641,"stars":23,"repoUrl":24,"updatedAt":2645},"docs-applies-to-tagging","validate applies_to tags in Elastic documentation","Validate and generate applies_to tags in Elastic documentation, including for cumulative docs across versions and deployment types. Use when writing new docs pages, reviewing existing pages for correct applies_to usage, deciding whether to preserve or replace existing version-scoped content, or when content changes lifecycle state (experimental, preview, beta, GA, deprecated, removed).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2642,2643,2644],{"name":17,"slug":18,"type":15},{"name":9,"slug":8,"type":15},{"name":21,"slug":22,"type":15},"2026-07-12T07:50:42.801473",{"slug":4,"name":4,"fn":5,"description":6,"org":2647,"tags":2648,"stars":23,"repoUrl":24,"updatedAt":25},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2649,2650,2651,2652],{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},{"name":9,"slug":8,"type":15},{"name":21,"slug":22,"type":15},{"slug":2654,"name":2654,"fn":2655,"description":2656,"org":2657,"tags":2658,"stars":23,"repoUrl":24,"updatedAt":2662},"docs-content-type-checker","check Elastic documentation content types","Check a docs-content page against Elastic content type guidelines (overview, how-to, tutorial, troubleshooting, changelog), or classify a proposed page idea against the content types before drafting. Use when the user asks to check content type compliance, validate page structure, review a doc against content type standards, or decide which content type a planned page should use.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2659,2660,2661],{"name":17,"slug":18,"type":15},{"name":9,"slug":8,"type":15},{"name":21,"slug":22,"type":15},"2026-07-12T07:50:36.826563",{"slug":2664,"name":2664,"fn":2665,"description":2666,"org":2667,"tags":2668,"stars":23,"repoUrl":24,"updatedAt":2671},"docs-draft-workflow-docs","draft Elastic Workflows documentation","Draft or update Elastic Workflows documentation pages in explore-analyze\u002Fworkflows\u002F — step references, use cases, how-tos, concepts, and overviews. Use when writing Workflows docs, documenting a step type, turning workflow YAML into documentation, drafting from a doc issue in docs-content or docs-content-internal, or creating a new page under the Workflows docset.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2669,2670],{"name":17,"slug":18,"type":15},{"name":21,"slug":22,"type":15},"2026-07-12T07:48:02.16095",{"slug":2673,"name":2673,"fn":2674,"description":2675,"org":2676,"tags":2677,"stars":23,"repoUrl":24,"updatedAt":2684},"docs-fix-changelog","improve Elastic changelog YAML files","Suggest improved text for changelog YAML files against current Elastic standards. Mirrors the pattern catalog from docs-review-changelog to provide consistent fixes. Includes type-title alignment checking and technical content assessment to catch overly technical titles that need user-focused rewrites. Features repository-aware area validation and enhanced confidence scoring. Supports single files or directories. Fetches canonical guidance to stay in sync. Use after review identifies quality issues, or when drafting new changelogs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2678,2679,2680,2681],{"name":17,"slug":18,"type":15},{"name":9,"slug":8,"type":15},{"name":21,"slug":22,"type":15},{"name":2682,"slug":2683,"type":15},"YAML","yaml","2026-07-12T07:48:58.570382",{"slug":2686,"name":2686,"fn":2687,"description":2688,"org":2689,"tags":2690,"stars":23,"repoUrl":24,"updatedAt":2694},"docs-flag-jargon-skill","flag Elastic jargon in documentation","Flag Elastic-internal jargon in documentation and suggest plain-language replacements. Use when reviewing, writing, or editing docs to catch terms that external readers would not understand.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2691,2692,2693],{"name":17,"slug":18,"type":15},{"name":9,"slug":8,"type":15},{"name":21,"slug":22,"type":15},"2026-07-12T07:49:34.836748",{"slug":2696,"name":2696,"fn":2697,"description":2698,"org":2699,"tags":2700,"stars":23,"repoUrl":24,"updatedAt":2705},"docs-frontmatter-audit","audit Elastic documentation frontmatter","Audit Elastic documentation files for frontmatter completeness and correctness. Checks products, description, and navigation_title fields across a directory. Use when auditing docs metadata, checking frontmatter quality before publishing, or validating a batch of files.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2701,2702,2703,2704],{"name":2589,"slug":2590,"type":15},{"name":17,"slug":18,"type":15},{"name":9,"slug":8,"type":15},{"name":21,"slug":22,"type":15},"2026-07-12T07:49:39.883351",18]