[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-elastic-docs-redirects":3,"mdc-7sh0pn-key":33,"related-repo-elastic-docs-redirects":1689,"related-org-elastic-docs-redirects":1770},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":20,"repoUrl":21,"updatedAt":22,"license":23,"forks":24,"topics":25,"repo":28,"sourceUrl":31,"mdContent":32},"docs-redirects","manage redirects in Elastic documentation","Create and manage redirects in Elastic documentation when pages are moved, renamed, or deleted. Use when moving docs pages, renaming files, restructuring content, or when the user asks about redirects.",{"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],{"name":13,"slug":14,"type":15},"SEO","seo","tag",{"name":17,"slug":18,"type":15},"Documentation","documentation",{"name":9,"slug":8,"type":15},71,"https:\u002F\u002Fgithub.com\u002Felastic\u002Felastic-docs-skills","2026-07-12T07:50:39.382463",null,9,[26,8,27],"docs","skills",{"repoUrl":21,"stars":20,"forks":24,"topics":29,"description":30},[26,8,27],"Instructions for code agents on how to author Elastic docs","https:\u002F\u002Fgithub.com\u002Felastic\u002Felastic-docs-skills\u002Ftree\u002FHEAD\u002Fskills\u002Fauthoring\u002Fdocs-redirects","---\nname: docs-redirects\nversion: 1.0.4\ndescription: Create and manage redirects in Elastic documentation when pages are moved, renamed, or deleted. Use when moving docs pages, renaming files, restructuring content, or when the user asks about redirects.\nargument-hint: \u003Cold-path> \u003Cnew-path>\ncontext: fork\nallowed-tools: Read, Grep, Glob, Edit, Write\nsources:\n  - https:\u002F\u002Fdocs-v3-preview.elastic.dev\u002Felastic\u002Fdocs-builder\u002Ftree\u002Fmain\u002Fcontribute\u002Fredirects\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 redirect specialist for Elastic Docs V3. Your job is to create and manage redirects in `redirects.yml` when documentation pages are moved, renamed, or deleted.\n\n## When to activate\n\nTrigger this skill when:\n- A `.md` file is being moved, renamed, or deleted\n- The user asks to create a redirect\n- A page restructure affects published URLs\n\n## How redirects work\n\nRedirects are configured in `redirects.yml` (or `_redirects.yml`), located next to the `docset.yml` (or `_docset.yml`) file in each content set. All paths are **relative to the `redirects.yml` file location**.\n\nRedirects only work within Elastic Docs V3 content sets. They cannot target external URLs.\n\n## Syntax reference\n\n### Simple redirect (preserves anchors)\n\n```yaml\nredirects:\n  'old\u002Fpath\u002Fpage.md': 'new\u002Fpath\u002Fpage.md'\n```\n\nAny anchors on the old URL are carried over to the new URL automatically.\n\n### Strip all anchors\n\nPrefix the target with `!` or use the expanded form:\n\n```yaml\nredirects:\n  # Short form\n  'old-page.md': '!new-page.md'\n\n  # Expanded form\n  'old-page.md':\n    to: 'new-page.md'\n    anchors: '!'\n```\n\n### Anchor mapping\n\nRemap specific anchors. Set a value to empty to drop that anchor:\n\n```yaml\nredirects:\n  'old-page.md':\n    to: 'new-page.md'\n    anchors:\n      'old-anchor': 'new-anchor'\n      'removed-anchor':\n```\n\n### Remove anchors on a page that still exists\n\nWhen a page hasn't moved but specific anchors were removed, omit the `to:` field:\n\n```yaml\nredirects:\n  'existing-page.md':\n    anchors:\n      'removed-anchor':\n```\n\n### Cross-repository redirects\n\nUse the `repo-name:\u002F\u002Fpath` syntax:\n\n```yaml\nredirects:\n  'old-page.md': 'other-repo:\u002F\u002Fpath\u002Fto\u002Fnew-page.md'\n```\n\n### Complex redirects (many targets)\n\nWhen different anchors on the old page need to redirect to different targets, use the `many:` key. Setting `to:` at the top level determines the default target for any anchor not matched by a `many:` entry:\n\n```yaml\nredirects:\n  # Default target stays on the same page; specific anchors redirect elsewhere\n  'old-page.md':\n    to: 'old-page.md'\n    many:\n      - to: 'target-two.md'\n        anchors:\n          'anchor-a': 'anchor-b'\n      - to: 'target-three.md'\n        anchors:\n          'anchor-c':\n\n  # Default target is a different page with anchors stripped\n  'deleted-page.md':\n    to: 'default-target.md'\n    anchors: '!'\n    many:\n      - to: 'target-two.md'\n        anchors:\n          'anchor-a': 'anchor-b'\n      - to: 'other-repo:\u002F\u002Fpath\u002Fto\u002Fnew-page.md'\n        anchors:\n          'anchor-b': 'anchor-c'\n```\n\nTo define a catch-all that matches any anchor not covered by individual entries, use `{}` as the anchor value:\n\n```yaml\nredirects:\n  'old-page.md':\n    many:\n      - to: 'specific-page.md'\n        anchors:\n          'section-one': 'new-section'\n      - to: 'catch-all-page.md'\n        anchors: {}\n```\n\nNotes:\n- Omitting the `anchors` key or setting it to empty are both equivalent.\n- Cross-repository targets (`other-repo:\u002F\u002Fpath`) are supported in `many:` entries.\n- `to:`, `anchors:`, and `many:` can be combined to handle complex scenarios.\n\n## Task execution\n\n1. **Find the redirects file**: Locate `redirects.yml` or `_redirects.yml` next to the content set's `docset.yml` or `_docset.yml`. If it doesn't exist, create it.\n\n2. **Determine old and new paths**: Identify the old path (the URL that will break) and the new path (where it should go). Both must be relative to the `redirects.yml` location.\n\n3. **Choose the redirect type**:\n   - Simple: page moved, anchors unchanged\n   - Anchor-stripping: target page has different structure, old anchors are meaningless\n   - Anchor-mapping: some anchors were renamed or removed\n   - Cross-repo: page moved to a different repository\n   - Many: old page's sections were split across multiple new pages\n\n4. **Add the redirect entry**: Edit `redirects.yml` to add the new entry under the `redirects:` key. If the file is new, create it with the `redirects:` top-level key.\n\n5. **Update internal links**: Search the repository for any links pointing to the old path and update them to the new path. Use Grep to find references:\n   - Markdown links: `](old\u002Fpath\u002Fpage.md`\n   - Cross-links from other repos: `repo-name:\u002F\u002Fold\u002Fpath\u002Fpage.md`\n   - Toctree entries referencing the old path\n\n6. **Report**: Summarize what was done — redirects added and links updated.\n\n## Validation\n\nRun `docs-builder diff validate` locally to verify all necessary redirect rules are in place after your changes. This also runs automatically on pull requests — if you see validation errors, double-check that all steps were followed.\n\n## Guidelines\n\n- Always use single quotes around paths in YAML to avoid escaping issues.\n- Keep entries sorted alphabetically by old path for readability.\n- When deleting a page, the redirect is mandatory — never leave a published URL without a redirect.\n- When moving multiple pages (e.g., restructuring a folder), add a redirect for each moved page.\n- If unsure whether a redirect is needed, it's safer to add one.\n",{"data":34,"body":41},{"name":4,"version":35,"description":6,"argument-hint":36,"context":37,"allowed-tools":38,"sources":39},"1.0.4","\u003Cold-path> \u003Cnew-path>","fork","Read, Grep, Glob, Edit, Write",[40],"https:\u002F\u002Fdocs-v3-preview.elastic.dev\u002Felastic\u002Fdocs-builder\u002Ftree\u002Fmain\u002Fcontribute\u002Fredirects",{"type":42,"children":43},"root",[44,61,68,73,101,107,157,162,168,175,244,249,255,268,419,425,430,555,561,574,642,648,661,711,717,744,1204,1217,1381,1386,1447,1453,1630,1636,1649,1655,1683],{"type":45,"tag":46,"props":47,"children":48},"element","p",{},[49,52,59],{"type":50,"value":51},"text","You are a redirect specialist for Elastic Docs V3. Your job is to create and manage redirects in ",{"type":45,"tag":53,"props":54,"children":56},"code",{"className":55},[],[57],{"type":50,"value":58},"redirects.yml",{"type":50,"value":60}," when documentation pages are moved, renamed, or deleted.",{"type":45,"tag":62,"props":63,"children":65},"h2",{"id":64},"when-to-activate",[66],{"type":50,"value":67},"When to activate",{"type":45,"tag":46,"props":69,"children":70},{},[71],{"type":50,"value":72},"Trigger this skill when:",{"type":45,"tag":74,"props":75,"children":76},"ul",{},[77,91,96],{"type":45,"tag":78,"props":79,"children":80},"li",{},[81,83,89],{"type":50,"value":82},"A ",{"type":45,"tag":53,"props":84,"children":86},{"className":85},[],[87],{"type":50,"value":88},".md",{"type":50,"value":90}," file is being moved, renamed, or deleted",{"type":45,"tag":78,"props":92,"children":93},{},[94],{"type":50,"value":95},"The user asks to create a redirect",{"type":45,"tag":78,"props":97,"children":98},{},[99],{"type":50,"value":100},"A page restructure affects published URLs",{"type":45,"tag":62,"props":102,"children":104},{"id":103},"how-redirects-work",[105],{"type":50,"value":106},"How redirects work",{"type":45,"tag":46,"props":108,"children":109},{},[110,112,117,119,125,127,133,134,140,142,155],{"type":50,"value":111},"Redirects are configured in ",{"type":45,"tag":53,"props":113,"children":115},{"className":114},[],[116],{"type":50,"value":58},{"type":50,"value":118}," (or ",{"type":45,"tag":53,"props":120,"children":122},{"className":121},[],[123],{"type":50,"value":124},"_redirects.yml",{"type":50,"value":126},"), located next to the ",{"type":45,"tag":53,"props":128,"children":130},{"className":129},[],[131],{"type":50,"value":132},"docset.yml",{"type":50,"value":118},{"type":45,"tag":53,"props":135,"children":137},{"className":136},[],[138],{"type":50,"value":139},"_docset.yml",{"type":50,"value":141},") file in each content set. All paths are ",{"type":45,"tag":143,"props":144,"children":145},"strong",{},[146,148,153],{"type":50,"value":147},"relative to the ",{"type":45,"tag":53,"props":149,"children":151},{"className":150},[],[152],{"type":50,"value":58},{"type":50,"value":154}," file location",{"type":50,"value":156},".",{"type":45,"tag":46,"props":158,"children":159},{},[160],{"type":50,"value":161},"Redirects only work within Elastic Docs V3 content sets. They cannot target external URLs.",{"type":45,"tag":62,"props":163,"children":165},{"id":164},"syntax-reference",[166],{"type":50,"value":167},"Syntax reference",{"type":45,"tag":169,"props":170,"children":172},"h3",{"id":171},"simple-redirect-preserves-anchors",[173],{"type":50,"value":174},"Simple redirect (preserves anchors)",{"type":45,"tag":176,"props":177,"children":182},"pre",{"className":178,"code":179,"language":180,"meta":181,"style":181},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","redirects:\n  'old\u002Fpath\u002Fpage.md': 'new\u002Fpath\u002Fpage.md'\n","yaml","",[183],{"type":45,"tag":53,"props":184,"children":185},{"__ignoreMap":181},[186,204],{"type":45,"tag":187,"props":188,"children":191},"span",{"class":189,"line":190},"line",1,[192,198],{"type":45,"tag":187,"props":193,"children":195},{"style":194},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[196],{"type":50,"value":197},"redirects",{"type":45,"tag":187,"props":199,"children":201},{"style":200},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[202],{"type":50,"value":203},":\n",{"type":45,"tag":187,"props":205,"children":207},{"class":189,"line":206},2,[208,213,219,224,229,234,239],{"type":45,"tag":187,"props":209,"children":210},{"style":200},[211],{"type":50,"value":212},"  '",{"type":45,"tag":187,"props":214,"children":216},{"style":215},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[217],{"type":50,"value":218},"old\u002Fpath\u002Fpage.md",{"type":45,"tag":187,"props":220,"children":221},{"style":200},[222],{"type":50,"value":223},"'",{"type":45,"tag":187,"props":225,"children":226},{"style":200},[227],{"type":50,"value":228},":",{"type":45,"tag":187,"props":230,"children":231},{"style":200},[232],{"type":50,"value":233}," '",{"type":45,"tag":187,"props":235,"children":236},{"style":215},[237],{"type":50,"value":238},"new\u002Fpath\u002Fpage.md",{"type":45,"tag":187,"props":240,"children":241},{"style":200},[242],{"type":50,"value":243},"'\n",{"type":45,"tag":46,"props":245,"children":246},{},[247],{"type":50,"value":248},"Any anchors on the old URL are carried over to the new URL automatically.",{"type":45,"tag":169,"props":250,"children":252},{"id":251},"strip-all-anchors",[253],{"type":50,"value":254},"Strip all anchors",{"type":45,"tag":46,"props":256,"children":257},{},[258,260,266],{"type":50,"value":259},"Prefix the target with ",{"type":45,"tag":53,"props":261,"children":263},{"className":262},[],[264],{"type":50,"value":265},"!",{"type":50,"value":267}," or use the expanded form:",{"type":45,"tag":176,"props":269,"children":271},{"className":178,"code":270,"language":180,"meta":181,"style":181},"redirects:\n  # Short form\n  'old-page.md': '!new-page.md'\n\n  # Expanded form\n  'old-page.md':\n    to: 'new-page.md'\n    anchors: '!'\n",[272],{"type":45,"tag":53,"props":273,"children":274},{"__ignoreMap":181},[275,286,295,329,339,348,368,394],{"type":45,"tag":187,"props":276,"children":277},{"class":189,"line":190},[278,282],{"type":45,"tag":187,"props":279,"children":280},{"style":194},[281],{"type":50,"value":197},{"type":45,"tag":187,"props":283,"children":284},{"style":200},[285],{"type":50,"value":203},{"type":45,"tag":187,"props":287,"children":288},{"class":189,"line":206},[289],{"type":45,"tag":187,"props":290,"children":292},{"style":291},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[293],{"type":50,"value":294},"  # Short form\n",{"type":45,"tag":187,"props":296,"children":298},{"class":189,"line":297},3,[299,303,308,312,316,320,325],{"type":45,"tag":187,"props":300,"children":301},{"style":200},[302],{"type":50,"value":212},{"type":45,"tag":187,"props":304,"children":305},{"style":215},[306],{"type":50,"value":307},"old-page.md",{"type":45,"tag":187,"props":309,"children":310},{"style":200},[311],{"type":50,"value":223},{"type":45,"tag":187,"props":313,"children":314},{"style":200},[315],{"type":50,"value":228},{"type":45,"tag":187,"props":317,"children":318},{"style":200},[319],{"type":50,"value":233},{"type":45,"tag":187,"props":321,"children":322},{"style":215},[323],{"type":50,"value":324},"!new-page.md",{"type":45,"tag":187,"props":326,"children":327},{"style":200},[328],{"type":50,"value":243},{"type":45,"tag":187,"props":330,"children":332},{"class":189,"line":331},4,[333],{"type":45,"tag":187,"props":334,"children":336},{"emptyLinePlaceholder":335},true,[337],{"type":50,"value":338},"\n",{"type":45,"tag":187,"props":340,"children":342},{"class":189,"line":341},5,[343],{"type":45,"tag":187,"props":344,"children":345},{"style":291},[346],{"type":50,"value":347},"  # Expanded form\n",{"type":45,"tag":187,"props":349,"children":351},{"class":189,"line":350},6,[352,356,360,364],{"type":45,"tag":187,"props":353,"children":354},{"style":200},[355],{"type":50,"value":212},{"type":45,"tag":187,"props":357,"children":358},{"style":215},[359],{"type":50,"value":307},{"type":45,"tag":187,"props":361,"children":362},{"style":200},[363],{"type":50,"value":223},{"type":45,"tag":187,"props":365,"children":366},{"style":200},[367],{"type":50,"value":203},{"type":45,"tag":187,"props":369,"children":371},{"class":189,"line":370},7,[372,377,381,385,390],{"type":45,"tag":187,"props":373,"children":374},{"style":194},[375],{"type":50,"value":376},"    to",{"type":45,"tag":187,"props":378,"children":379},{"style":200},[380],{"type":50,"value":228},{"type":45,"tag":187,"props":382,"children":383},{"style":200},[384],{"type":50,"value":233},{"type":45,"tag":187,"props":386,"children":387},{"style":215},[388],{"type":50,"value":389},"new-page.md",{"type":45,"tag":187,"props":391,"children":392},{"style":200},[393],{"type":50,"value":243},{"type":45,"tag":187,"props":395,"children":397},{"class":189,"line":396},8,[398,403,407,411,415],{"type":45,"tag":187,"props":399,"children":400},{"style":194},[401],{"type":50,"value":402},"    anchors",{"type":45,"tag":187,"props":404,"children":405},{"style":200},[406],{"type":50,"value":228},{"type":45,"tag":187,"props":408,"children":409},{"style":200},[410],{"type":50,"value":233},{"type":45,"tag":187,"props":412,"children":413},{"style":215},[414],{"type":50,"value":265},{"type":45,"tag":187,"props":416,"children":417},{"style":200},[418],{"type":50,"value":243},{"type":45,"tag":169,"props":420,"children":422},{"id":421},"anchor-mapping",[423],{"type":50,"value":424},"Anchor mapping",{"type":45,"tag":46,"props":426,"children":427},{},[428],{"type":50,"value":429},"Remap specific anchors. Set a value to empty to drop that anchor:",{"type":45,"tag":176,"props":431,"children":433},{"className":178,"code":432,"language":180,"meta":181,"style":181},"redirects:\n  'old-page.md':\n    to: 'new-page.md'\n    anchors:\n      'old-anchor': 'new-anchor'\n      'removed-anchor':\n",[434],{"type":45,"tag":53,"props":435,"children":436},{"__ignoreMap":181},[437,448,467,490,501,535],{"type":45,"tag":187,"props":438,"children":439},{"class":189,"line":190},[440,444],{"type":45,"tag":187,"props":441,"children":442},{"style":194},[443],{"type":50,"value":197},{"type":45,"tag":187,"props":445,"children":446},{"style":200},[447],{"type":50,"value":203},{"type":45,"tag":187,"props":449,"children":450},{"class":189,"line":206},[451,455,459,463],{"type":45,"tag":187,"props":452,"children":453},{"style":200},[454],{"type":50,"value":212},{"type":45,"tag":187,"props":456,"children":457},{"style":215},[458],{"type":50,"value":307},{"type":45,"tag":187,"props":460,"children":461},{"style":200},[462],{"type":50,"value":223},{"type":45,"tag":187,"props":464,"children":465},{"style":200},[466],{"type":50,"value":203},{"type":45,"tag":187,"props":468,"children":469},{"class":189,"line":297},[470,474,478,482,486],{"type":45,"tag":187,"props":471,"children":472},{"style":194},[473],{"type":50,"value":376},{"type":45,"tag":187,"props":475,"children":476},{"style":200},[477],{"type":50,"value":228},{"type":45,"tag":187,"props":479,"children":480},{"style":200},[481],{"type":50,"value":233},{"type":45,"tag":187,"props":483,"children":484},{"style":215},[485],{"type":50,"value":389},{"type":45,"tag":187,"props":487,"children":488},{"style":200},[489],{"type":50,"value":243},{"type":45,"tag":187,"props":491,"children":492},{"class":189,"line":331},[493,497],{"type":45,"tag":187,"props":494,"children":495},{"style":194},[496],{"type":50,"value":402},{"type":45,"tag":187,"props":498,"children":499},{"style":200},[500],{"type":50,"value":203},{"type":45,"tag":187,"props":502,"children":503},{"class":189,"line":341},[504,509,514,518,522,526,531],{"type":45,"tag":187,"props":505,"children":506},{"style":200},[507],{"type":50,"value":508},"      '",{"type":45,"tag":187,"props":510,"children":511},{"style":215},[512],{"type":50,"value":513},"old-anchor",{"type":45,"tag":187,"props":515,"children":516},{"style":200},[517],{"type":50,"value":223},{"type":45,"tag":187,"props":519,"children":520},{"style":200},[521],{"type":50,"value":228},{"type":45,"tag":187,"props":523,"children":524},{"style":200},[525],{"type":50,"value":233},{"type":45,"tag":187,"props":527,"children":528},{"style":215},[529],{"type":50,"value":530},"new-anchor",{"type":45,"tag":187,"props":532,"children":533},{"style":200},[534],{"type":50,"value":243},{"type":45,"tag":187,"props":536,"children":537},{"class":189,"line":350},[538,542,547,551],{"type":45,"tag":187,"props":539,"children":540},{"style":200},[541],{"type":50,"value":508},{"type":45,"tag":187,"props":543,"children":544},{"style":215},[545],{"type":50,"value":546},"removed-anchor",{"type":45,"tag":187,"props":548,"children":549},{"style":200},[550],{"type":50,"value":223},{"type":45,"tag":187,"props":552,"children":553},{"style":200},[554],{"type":50,"value":203},{"type":45,"tag":169,"props":556,"children":558},{"id":557},"remove-anchors-on-a-page-that-still-exists",[559],{"type":50,"value":560},"Remove anchors on a page that still exists",{"type":45,"tag":46,"props":562,"children":563},{},[564,566,572],{"type":50,"value":565},"When a page hasn't moved but specific anchors were removed, omit the ",{"type":45,"tag":53,"props":567,"children":569},{"className":568},[],[570],{"type":50,"value":571},"to:",{"type":50,"value":573}," field:",{"type":45,"tag":176,"props":575,"children":577},{"className":178,"code":576,"language":180,"meta":181,"style":181},"redirects:\n  'existing-page.md':\n    anchors:\n      'removed-anchor':\n",[578],{"type":45,"tag":53,"props":579,"children":580},{"__ignoreMap":181},[581,592,612,623],{"type":45,"tag":187,"props":582,"children":583},{"class":189,"line":190},[584,588],{"type":45,"tag":187,"props":585,"children":586},{"style":194},[587],{"type":50,"value":197},{"type":45,"tag":187,"props":589,"children":590},{"style":200},[591],{"type":50,"value":203},{"type":45,"tag":187,"props":593,"children":594},{"class":189,"line":206},[595,599,604,608],{"type":45,"tag":187,"props":596,"children":597},{"style":200},[598],{"type":50,"value":212},{"type":45,"tag":187,"props":600,"children":601},{"style":215},[602],{"type":50,"value":603},"existing-page.md",{"type":45,"tag":187,"props":605,"children":606},{"style":200},[607],{"type":50,"value":223},{"type":45,"tag":187,"props":609,"children":610},{"style":200},[611],{"type":50,"value":203},{"type":45,"tag":187,"props":613,"children":614},{"class":189,"line":297},[615,619],{"type":45,"tag":187,"props":616,"children":617},{"style":194},[618],{"type":50,"value":402},{"type":45,"tag":187,"props":620,"children":621},{"style":200},[622],{"type":50,"value":203},{"type":45,"tag":187,"props":624,"children":625},{"class":189,"line":331},[626,630,634,638],{"type":45,"tag":187,"props":627,"children":628},{"style":200},[629],{"type":50,"value":508},{"type":45,"tag":187,"props":631,"children":632},{"style":215},[633],{"type":50,"value":546},{"type":45,"tag":187,"props":635,"children":636},{"style":200},[637],{"type":50,"value":223},{"type":45,"tag":187,"props":639,"children":640},{"style":200},[641],{"type":50,"value":203},{"type":45,"tag":169,"props":643,"children":645},{"id":644},"cross-repository-redirects",[646],{"type":50,"value":647},"Cross-repository redirects",{"type":45,"tag":46,"props":649,"children":650},{},[651,653,659],{"type":50,"value":652},"Use the ",{"type":45,"tag":53,"props":654,"children":656},{"className":655},[],[657],{"type":50,"value":658},"repo-name:\u002F\u002Fpath",{"type":50,"value":660}," syntax:",{"type":45,"tag":176,"props":662,"children":664},{"className":178,"code":663,"language":180,"meta":181,"style":181},"redirects:\n  'old-page.md': 'other-repo:\u002F\u002Fpath\u002Fto\u002Fnew-page.md'\n",[665],{"type":45,"tag":53,"props":666,"children":667},{"__ignoreMap":181},[668,679],{"type":45,"tag":187,"props":669,"children":670},{"class":189,"line":190},[671,675],{"type":45,"tag":187,"props":672,"children":673},{"style":194},[674],{"type":50,"value":197},{"type":45,"tag":187,"props":676,"children":677},{"style":200},[678],{"type":50,"value":203},{"type":45,"tag":187,"props":680,"children":681},{"class":189,"line":206},[682,686,690,694,698,702,707],{"type":45,"tag":187,"props":683,"children":684},{"style":200},[685],{"type":50,"value":212},{"type":45,"tag":187,"props":687,"children":688},{"style":215},[689],{"type":50,"value":307},{"type":45,"tag":187,"props":691,"children":692},{"style":200},[693],{"type":50,"value":223},{"type":45,"tag":187,"props":695,"children":696},{"style":200},[697],{"type":50,"value":228},{"type":45,"tag":187,"props":699,"children":700},{"style":200},[701],{"type":50,"value":233},{"type":45,"tag":187,"props":703,"children":704},{"style":215},[705],{"type":50,"value":706},"other-repo:\u002F\u002Fpath\u002Fto\u002Fnew-page.md",{"type":45,"tag":187,"props":708,"children":709},{"style":200},[710],{"type":50,"value":243},{"type":45,"tag":169,"props":712,"children":714},{"id":713},"complex-redirects-many-targets",[715],{"type":50,"value":716},"Complex redirects (many targets)",{"type":45,"tag":46,"props":718,"children":719},{},[720,722,728,730,735,737,742],{"type":50,"value":721},"When different anchors on the old page need to redirect to different targets, use the ",{"type":45,"tag":53,"props":723,"children":725},{"className":724},[],[726],{"type":50,"value":727},"many:",{"type":50,"value":729}," key. Setting ",{"type":45,"tag":53,"props":731,"children":733},{"className":732},[],[734],{"type":50,"value":571},{"type":50,"value":736}," at the top level determines the default target for any anchor not matched by a ",{"type":45,"tag":53,"props":738,"children":740},{"className":739},[],[741],{"type":50,"value":727},{"type":50,"value":743}," entry:",{"type":45,"tag":176,"props":745,"children":747},{"className":178,"code":746,"language":180,"meta":181,"style":181},"redirects:\n  # Default target stays on the same page; specific anchors redirect elsewhere\n  'old-page.md':\n    to: 'old-page.md'\n    many:\n      - to: 'target-two.md'\n        anchors:\n          'anchor-a': 'anchor-b'\n      - to: 'target-three.md'\n        anchors:\n          'anchor-c':\n\n  # Default target is a different page with anchors stripped\n  'deleted-page.md':\n    to: 'default-target.md'\n    anchors: '!'\n    many:\n      - to: 'target-two.md'\n        anchors:\n          'anchor-a': 'anchor-b'\n      - to: 'other-repo:\u002F\u002Fpath\u002Fto\u002Fnew-page.md'\n        anchors:\n          'anchor-b': 'anchor-c'\n",[748],{"type":45,"tag":53,"props":749,"children":750},{"__ignoreMap":181},[751,762,770,789,812,824,854,866,900,928,940,961,969,978,999,1024,1048,1060,1088,1100,1132,1160,1172],{"type":45,"tag":187,"props":752,"children":753},{"class":189,"line":190},[754,758],{"type":45,"tag":187,"props":755,"children":756},{"style":194},[757],{"type":50,"value":197},{"type":45,"tag":187,"props":759,"children":760},{"style":200},[761],{"type":50,"value":203},{"type":45,"tag":187,"props":763,"children":764},{"class":189,"line":206},[765],{"type":45,"tag":187,"props":766,"children":767},{"style":291},[768],{"type":50,"value":769},"  # Default target stays on the same page; specific anchors redirect elsewhere\n",{"type":45,"tag":187,"props":771,"children":772},{"class":189,"line":297},[773,777,781,785],{"type":45,"tag":187,"props":774,"children":775},{"style":200},[776],{"type":50,"value":212},{"type":45,"tag":187,"props":778,"children":779},{"style":215},[780],{"type":50,"value":307},{"type":45,"tag":187,"props":782,"children":783},{"style":200},[784],{"type":50,"value":223},{"type":45,"tag":187,"props":786,"children":787},{"style":200},[788],{"type":50,"value":203},{"type":45,"tag":187,"props":790,"children":791},{"class":189,"line":331},[792,796,800,804,808],{"type":45,"tag":187,"props":793,"children":794},{"style":194},[795],{"type":50,"value":376},{"type":45,"tag":187,"props":797,"children":798},{"style":200},[799],{"type":50,"value":228},{"type":45,"tag":187,"props":801,"children":802},{"style":200},[803],{"type":50,"value":233},{"type":45,"tag":187,"props":805,"children":806},{"style":215},[807],{"type":50,"value":307},{"type":45,"tag":187,"props":809,"children":810},{"style":200},[811],{"type":50,"value":243},{"type":45,"tag":187,"props":813,"children":814},{"class":189,"line":341},[815,820],{"type":45,"tag":187,"props":816,"children":817},{"style":194},[818],{"type":50,"value":819},"    many",{"type":45,"tag":187,"props":821,"children":822},{"style":200},[823],{"type":50,"value":203},{"type":45,"tag":187,"props":825,"children":826},{"class":189,"line":350},[827,832,837,841,845,850],{"type":45,"tag":187,"props":828,"children":829},{"style":200},[830],{"type":50,"value":831},"      -",{"type":45,"tag":187,"props":833,"children":834},{"style":194},[835],{"type":50,"value":836}," to",{"type":45,"tag":187,"props":838,"children":839},{"style":200},[840],{"type":50,"value":228},{"type":45,"tag":187,"props":842,"children":843},{"style":200},[844],{"type":50,"value":233},{"type":45,"tag":187,"props":846,"children":847},{"style":215},[848],{"type":50,"value":849},"target-two.md",{"type":45,"tag":187,"props":851,"children":852},{"style":200},[853],{"type":50,"value":243},{"type":45,"tag":187,"props":855,"children":856},{"class":189,"line":370},[857,862],{"type":45,"tag":187,"props":858,"children":859},{"style":194},[860],{"type":50,"value":861},"        anchors",{"type":45,"tag":187,"props":863,"children":864},{"style":200},[865],{"type":50,"value":203},{"type":45,"tag":187,"props":867,"children":868},{"class":189,"line":396},[869,874,879,883,887,891,896],{"type":45,"tag":187,"props":870,"children":871},{"style":200},[872],{"type":50,"value":873},"          '",{"type":45,"tag":187,"props":875,"children":876},{"style":215},[877],{"type":50,"value":878},"anchor-a",{"type":45,"tag":187,"props":880,"children":881},{"style":200},[882],{"type":50,"value":223},{"type":45,"tag":187,"props":884,"children":885},{"style":200},[886],{"type":50,"value":228},{"type":45,"tag":187,"props":888,"children":889},{"style":200},[890],{"type":50,"value":233},{"type":45,"tag":187,"props":892,"children":893},{"style":215},[894],{"type":50,"value":895},"anchor-b",{"type":45,"tag":187,"props":897,"children":898},{"style":200},[899],{"type":50,"value":243},{"type":45,"tag":187,"props":901,"children":902},{"class":189,"line":24},[903,907,911,915,919,924],{"type":45,"tag":187,"props":904,"children":905},{"style":200},[906],{"type":50,"value":831},{"type":45,"tag":187,"props":908,"children":909},{"style":194},[910],{"type":50,"value":836},{"type":45,"tag":187,"props":912,"children":913},{"style":200},[914],{"type":50,"value":228},{"type":45,"tag":187,"props":916,"children":917},{"style":200},[918],{"type":50,"value":233},{"type":45,"tag":187,"props":920,"children":921},{"style":215},[922],{"type":50,"value":923},"target-three.md",{"type":45,"tag":187,"props":925,"children":926},{"style":200},[927],{"type":50,"value":243},{"type":45,"tag":187,"props":929,"children":931},{"class":189,"line":930},10,[932,936],{"type":45,"tag":187,"props":933,"children":934},{"style":194},[935],{"type":50,"value":861},{"type":45,"tag":187,"props":937,"children":938},{"style":200},[939],{"type":50,"value":203},{"type":45,"tag":187,"props":941,"children":943},{"class":189,"line":942},11,[944,948,953,957],{"type":45,"tag":187,"props":945,"children":946},{"style":200},[947],{"type":50,"value":873},{"type":45,"tag":187,"props":949,"children":950},{"style":215},[951],{"type":50,"value":952},"anchor-c",{"type":45,"tag":187,"props":954,"children":955},{"style":200},[956],{"type":50,"value":223},{"type":45,"tag":187,"props":958,"children":959},{"style":200},[960],{"type":50,"value":203},{"type":45,"tag":187,"props":962,"children":964},{"class":189,"line":963},12,[965],{"type":45,"tag":187,"props":966,"children":967},{"emptyLinePlaceholder":335},[968],{"type":50,"value":338},{"type":45,"tag":187,"props":970,"children":972},{"class":189,"line":971},13,[973],{"type":45,"tag":187,"props":974,"children":975},{"style":291},[976],{"type":50,"value":977},"  # Default target is a different page with anchors stripped\n",{"type":45,"tag":187,"props":979,"children":981},{"class":189,"line":980},14,[982,986,991,995],{"type":45,"tag":187,"props":983,"children":984},{"style":200},[985],{"type":50,"value":212},{"type":45,"tag":187,"props":987,"children":988},{"style":215},[989],{"type":50,"value":990},"deleted-page.md",{"type":45,"tag":187,"props":992,"children":993},{"style":200},[994],{"type":50,"value":223},{"type":45,"tag":187,"props":996,"children":997},{"style":200},[998],{"type":50,"value":203},{"type":45,"tag":187,"props":1000,"children":1002},{"class":189,"line":1001},15,[1003,1007,1011,1015,1020],{"type":45,"tag":187,"props":1004,"children":1005},{"style":194},[1006],{"type":50,"value":376},{"type":45,"tag":187,"props":1008,"children":1009},{"style":200},[1010],{"type":50,"value":228},{"type":45,"tag":187,"props":1012,"children":1013},{"style":200},[1014],{"type":50,"value":233},{"type":45,"tag":187,"props":1016,"children":1017},{"style":215},[1018],{"type":50,"value":1019},"default-target.md",{"type":45,"tag":187,"props":1021,"children":1022},{"style":200},[1023],{"type":50,"value":243},{"type":45,"tag":187,"props":1025,"children":1027},{"class":189,"line":1026},16,[1028,1032,1036,1040,1044],{"type":45,"tag":187,"props":1029,"children":1030},{"style":194},[1031],{"type":50,"value":402},{"type":45,"tag":187,"props":1033,"children":1034},{"style":200},[1035],{"type":50,"value":228},{"type":45,"tag":187,"props":1037,"children":1038},{"style":200},[1039],{"type":50,"value":233},{"type":45,"tag":187,"props":1041,"children":1042},{"style":215},[1043],{"type":50,"value":265},{"type":45,"tag":187,"props":1045,"children":1046},{"style":200},[1047],{"type":50,"value":243},{"type":45,"tag":187,"props":1049,"children":1051},{"class":189,"line":1050},17,[1052,1056],{"type":45,"tag":187,"props":1053,"children":1054},{"style":194},[1055],{"type":50,"value":819},{"type":45,"tag":187,"props":1057,"children":1058},{"style":200},[1059],{"type":50,"value":203},{"type":45,"tag":187,"props":1061,"children":1063},{"class":189,"line":1062},18,[1064,1068,1072,1076,1080,1084],{"type":45,"tag":187,"props":1065,"children":1066},{"style":200},[1067],{"type":50,"value":831},{"type":45,"tag":187,"props":1069,"children":1070},{"style":194},[1071],{"type":50,"value":836},{"type":45,"tag":187,"props":1073,"children":1074},{"style":200},[1075],{"type":50,"value":228},{"type":45,"tag":187,"props":1077,"children":1078},{"style":200},[1079],{"type":50,"value":233},{"type":45,"tag":187,"props":1081,"children":1082},{"style":215},[1083],{"type":50,"value":849},{"type":45,"tag":187,"props":1085,"children":1086},{"style":200},[1087],{"type":50,"value":243},{"type":45,"tag":187,"props":1089,"children":1091},{"class":189,"line":1090},19,[1092,1096],{"type":45,"tag":187,"props":1093,"children":1094},{"style":194},[1095],{"type":50,"value":861},{"type":45,"tag":187,"props":1097,"children":1098},{"style":200},[1099],{"type":50,"value":203},{"type":45,"tag":187,"props":1101,"children":1103},{"class":189,"line":1102},20,[1104,1108,1112,1116,1120,1124,1128],{"type":45,"tag":187,"props":1105,"children":1106},{"style":200},[1107],{"type":50,"value":873},{"type":45,"tag":187,"props":1109,"children":1110},{"style":215},[1111],{"type":50,"value":878},{"type":45,"tag":187,"props":1113,"children":1114},{"style":200},[1115],{"type":50,"value":223},{"type":45,"tag":187,"props":1117,"children":1118},{"style":200},[1119],{"type":50,"value":228},{"type":45,"tag":187,"props":1121,"children":1122},{"style":200},[1123],{"type":50,"value":233},{"type":45,"tag":187,"props":1125,"children":1126},{"style":215},[1127],{"type":50,"value":895},{"type":45,"tag":187,"props":1129,"children":1130},{"style":200},[1131],{"type":50,"value":243},{"type":45,"tag":187,"props":1133,"children":1135},{"class":189,"line":1134},21,[1136,1140,1144,1148,1152,1156],{"type":45,"tag":187,"props":1137,"children":1138},{"style":200},[1139],{"type":50,"value":831},{"type":45,"tag":187,"props":1141,"children":1142},{"style":194},[1143],{"type":50,"value":836},{"type":45,"tag":187,"props":1145,"children":1146},{"style":200},[1147],{"type":50,"value":228},{"type":45,"tag":187,"props":1149,"children":1150},{"style":200},[1151],{"type":50,"value":233},{"type":45,"tag":187,"props":1153,"children":1154},{"style":215},[1155],{"type":50,"value":706},{"type":45,"tag":187,"props":1157,"children":1158},{"style":200},[1159],{"type":50,"value":243},{"type":45,"tag":187,"props":1161,"children":1163},{"class":189,"line":1162},22,[1164,1168],{"type":45,"tag":187,"props":1165,"children":1166},{"style":194},[1167],{"type":50,"value":861},{"type":45,"tag":187,"props":1169,"children":1170},{"style":200},[1171],{"type":50,"value":203},{"type":45,"tag":187,"props":1173,"children":1175},{"class":189,"line":1174},23,[1176,1180,1184,1188,1192,1196,1200],{"type":45,"tag":187,"props":1177,"children":1178},{"style":200},[1179],{"type":50,"value":873},{"type":45,"tag":187,"props":1181,"children":1182},{"style":215},[1183],{"type":50,"value":895},{"type":45,"tag":187,"props":1185,"children":1186},{"style":200},[1187],{"type":50,"value":223},{"type":45,"tag":187,"props":1189,"children":1190},{"style":200},[1191],{"type":50,"value":228},{"type":45,"tag":187,"props":1193,"children":1194},{"style":200},[1195],{"type":50,"value":233},{"type":45,"tag":187,"props":1197,"children":1198},{"style":215},[1199],{"type":50,"value":952},{"type":45,"tag":187,"props":1201,"children":1202},{"style":200},[1203],{"type":50,"value":243},{"type":45,"tag":46,"props":1205,"children":1206},{},[1207,1209,1215],{"type":50,"value":1208},"To define a catch-all that matches any anchor not covered by individual entries, use ",{"type":45,"tag":53,"props":1210,"children":1212},{"className":1211},[],[1213],{"type":50,"value":1214},"{}",{"type":50,"value":1216}," as the anchor value:",{"type":45,"tag":176,"props":1218,"children":1220},{"className":178,"code":1219,"language":180,"meta":181,"style":181},"redirects:\n  'old-page.md':\n    many:\n      - to: 'specific-page.md'\n        anchors:\n          'section-one': 'new-section'\n      - to: 'catch-all-page.md'\n        anchors: {}\n",[1221],{"type":45,"tag":53,"props":1222,"children":1223},{"__ignoreMap":181},[1224,1235,1254,1265,1293,1304,1337,1365],{"type":45,"tag":187,"props":1225,"children":1226},{"class":189,"line":190},[1227,1231],{"type":45,"tag":187,"props":1228,"children":1229},{"style":194},[1230],{"type":50,"value":197},{"type":45,"tag":187,"props":1232,"children":1233},{"style":200},[1234],{"type":50,"value":203},{"type":45,"tag":187,"props":1236,"children":1237},{"class":189,"line":206},[1238,1242,1246,1250],{"type":45,"tag":187,"props":1239,"children":1240},{"style":200},[1241],{"type":50,"value":212},{"type":45,"tag":187,"props":1243,"children":1244},{"style":215},[1245],{"type":50,"value":307},{"type":45,"tag":187,"props":1247,"children":1248},{"style":200},[1249],{"type":50,"value":223},{"type":45,"tag":187,"props":1251,"children":1252},{"style":200},[1253],{"type":50,"value":203},{"type":45,"tag":187,"props":1255,"children":1256},{"class":189,"line":297},[1257,1261],{"type":45,"tag":187,"props":1258,"children":1259},{"style":194},[1260],{"type":50,"value":819},{"type":45,"tag":187,"props":1262,"children":1263},{"style":200},[1264],{"type":50,"value":203},{"type":45,"tag":187,"props":1266,"children":1267},{"class":189,"line":331},[1268,1272,1276,1280,1284,1289],{"type":45,"tag":187,"props":1269,"children":1270},{"style":200},[1271],{"type":50,"value":831},{"type":45,"tag":187,"props":1273,"children":1274},{"style":194},[1275],{"type":50,"value":836},{"type":45,"tag":187,"props":1277,"children":1278},{"style":200},[1279],{"type":50,"value":228},{"type":45,"tag":187,"props":1281,"children":1282},{"style":200},[1283],{"type":50,"value":233},{"type":45,"tag":187,"props":1285,"children":1286},{"style":215},[1287],{"type":50,"value":1288},"specific-page.md",{"type":45,"tag":187,"props":1290,"children":1291},{"style":200},[1292],{"type":50,"value":243},{"type":45,"tag":187,"props":1294,"children":1295},{"class":189,"line":341},[1296,1300],{"type":45,"tag":187,"props":1297,"children":1298},{"style":194},[1299],{"type":50,"value":861},{"type":45,"tag":187,"props":1301,"children":1302},{"style":200},[1303],{"type":50,"value":203},{"type":45,"tag":187,"props":1305,"children":1306},{"class":189,"line":350},[1307,1311,1316,1320,1324,1328,1333],{"type":45,"tag":187,"props":1308,"children":1309},{"style":200},[1310],{"type":50,"value":873},{"type":45,"tag":187,"props":1312,"children":1313},{"style":215},[1314],{"type":50,"value":1315},"section-one",{"type":45,"tag":187,"props":1317,"children":1318},{"style":200},[1319],{"type":50,"value":223},{"type":45,"tag":187,"props":1321,"children":1322},{"style":200},[1323],{"type":50,"value":228},{"type":45,"tag":187,"props":1325,"children":1326},{"style":200},[1327],{"type":50,"value":233},{"type":45,"tag":187,"props":1329,"children":1330},{"style":215},[1331],{"type":50,"value":1332},"new-section",{"type":45,"tag":187,"props":1334,"children":1335},{"style":200},[1336],{"type":50,"value":243},{"type":45,"tag":187,"props":1338,"children":1339},{"class":189,"line":370},[1340,1344,1348,1352,1356,1361],{"type":45,"tag":187,"props":1341,"children":1342},{"style":200},[1343],{"type":50,"value":831},{"type":45,"tag":187,"props":1345,"children":1346},{"style":194},[1347],{"type":50,"value":836},{"type":45,"tag":187,"props":1349,"children":1350},{"style":200},[1351],{"type":50,"value":228},{"type":45,"tag":187,"props":1353,"children":1354},{"style":200},[1355],{"type":50,"value":233},{"type":45,"tag":187,"props":1357,"children":1358},{"style":215},[1359],{"type":50,"value":1360},"catch-all-page.md",{"type":45,"tag":187,"props":1362,"children":1363},{"style":200},[1364],{"type":50,"value":243},{"type":45,"tag":187,"props":1366,"children":1367},{"class":189,"line":396},[1368,1372,1376],{"type":45,"tag":187,"props":1369,"children":1370},{"style":194},[1371],{"type":50,"value":861},{"type":45,"tag":187,"props":1373,"children":1374},{"style":200},[1375],{"type":50,"value":228},{"type":45,"tag":187,"props":1377,"children":1378},{"style":200},[1379],{"type":50,"value":1380}," {}\n",{"type":45,"tag":46,"props":1382,"children":1383},{},[1384],{"type":50,"value":1385},"Notes:",{"type":45,"tag":74,"props":1387,"children":1388},{},[1389,1402,1422],{"type":45,"tag":78,"props":1390,"children":1391},{},[1392,1394,1400],{"type":50,"value":1393},"Omitting the ",{"type":45,"tag":53,"props":1395,"children":1397},{"className":1396},[],[1398],{"type":50,"value":1399},"anchors",{"type":50,"value":1401}," key or setting it to empty are both equivalent.",{"type":45,"tag":78,"props":1403,"children":1404},{},[1405,1407,1413,1415,1420],{"type":50,"value":1406},"Cross-repository targets (",{"type":45,"tag":53,"props":1408,"children":1410},{"className":1409},[],[1411],{"type":50,"value":1412},"other-repo:\u002F\u002Fpath",{"type":50,"value":1414},") are supported in ",{"type":45,"tag":53,"props":1416,"children":1418},{"className":1417},[],[1419],{"type":50,"value":727},{"type":50,"value":1421}," entries.",{"type":45,"tag":78,"props":1423,"children":1424},{},[1425,1430,1432,1438,1440,1445],{"type":45,"tag":53,"props":1426,"children":1428},{"className":1427},[],[1429],{"type":50,"value":571},{"type":50,"value":1431},", ",{"type":45,"tag":53,"props":1433,"children":1435},{"className":1434},[],[1436],{"type":50,"value":1437},"anchors:",{"type":50,"value":1439},", and ",{"type":45,"tag":53,"props":1441,"children":1443},{"className":1442},[],[1444],{"type":50,"value":727},{"type":50,"value":1446}," can be combined to handle complex scenarios.",{"type":45,"tag":62,"props":1448,"children":1450},{"id":1449},"task-execution",[1451],{"type":50,"value":1452},"Task execution",{"type":45,"tag":1454,"props":1455,"children":1456},"ol",{},[1457,1494,1511,1548,1580,1620],{"type":45,"tag":78,"props":1458,"children":1459},{},[1460,1465,1467,1472,1474,1479,1481,1486,1487,1492],{"type":45,"tag":143,"props":1461,"children":1462},{},[1463],{"type":50,"value":1464},"Find the redirects file",{"type":50,"value":1466},": Locate ",{"type":45,"tag":53,"props":1468,"children":1470},{"className":1469},[],[1471],{"type":50,"value":58},{"type":50,"value":1473}," or ",{"type":45,"tag":53,"props":1475,"children":1477},{"className":1476},[],[1478],{"type":50,"value":124},{"type":50,"value":1480}," next to the content set's ",{"type":45,"tag":53,"props":1482,"children":1484},{"className":1483},[],[1485],{"type":50,"value":132},{"type":50,"value":1473},{"type":45,"tag":53,"props":1488,"children":1490},{"className":1489},[],[1491],{"type":50,"value":139},{"type":50,"value":1493},". If it doesn't exist, create it.",{"type":45,"tag":78,"props":1495,"children":1496},{},[1497,1502,1504,1509],{"type":45,"tag":143,"props":1498,"children":1499},{},[1500],{"type":50,"value":1501},"Determine old and new paths",{"type":50,"value":1503},": Identify the old path (the URL that will break) and the new path (where it should go). Both must be relative to the ",{"type":45,"tag":53,"props":1505,"children":1507},{"className":1506},[],[1508],{"type":50,"value":58},{"type":50,"value":1510}," location.",{"type":45,"tag":78,"props":1512,"children":1513},{},[1514,1519,1520],{"type":45,"tag":143,"props":1515,"children":1516},{},[1517],{"type":50,"value":1518},"Choose the redirect type",{"type":50,"value":228},{"type":45,"tag":74,"props":1521,"children":1522},{},[1523,1528,1533,1538,1543],{"type":45,"tag":78,"props":1524,"children":1525},{},[1526],{"type":50,"value":1527},"Simple: page moved, anchors unchanged",{"type":45,"tag":78,"props":1529,"children":1530},{},[1531],{"type":50,"value":1532},"Anchor-stripping: target page has different structure, old anchors are meaningless",{"type":45,"tag":78,"props":1534,"children":1535},{},[1536],{"type":50,"value":1537},"Anchor-mapping: some anchors were renamed or removed",{"type":45,"tag":78,"props":1539,"children":1540},{},[1541],{"type":50,"value":1542},"Cross-repo: page moved to a different repository",{"type":45,"tag":78,"props":1544,"children":1545},{},[1546],{"type":50,"value":1547},"Many: old page's sections were split across multiple new pages",{"type":45,"tag":78,"props":1549,"children":1550},{},[1551,1556,1558,1563,1565,1571,1573,1578],{"type":45,"tag":143,"props":1552,"children":1553},{},[1554],{"type":50,"value":1555},"Add the redirect entry",{"type":50,"value":1557},": Edit ",{"type":45,"tag":53,"props":1559,"children":1561},{"className":1560},[],[1562],{"type":50,"value":58},{"type":50,"value":1564}," to add the new entry under the ",{"type":45,"tag":53,"props":1566,"children":1568},{"className":1567},[],[1569],{"type":50,"value":1570},"redirects:",{"type":50,"value":1572}," key. If the file is new, create it with the ",{"type":45,"tag":53,"props":1574,"children":1576},{"className":1575},[],[1577],{"type":50,"value":1570},{"type":50,"value":1579}," top-level key.",{"type":45,"tag":78,"props":1581,"children":1582},{},[1583,1588,1590],{"type":45,"tag":143,"props":1584,"children":1585},{},[1586],{"type":50,"value":1587},"Update internal links",{"type":50,"value":1589},": Search the repository for any links pointing to the old path and update them to the new path. Use Grep to find references:",{"type":45,"tag":74,"props":1591,"children":1592},{},[1593,1604,1615],{"type":45,"tag":78,"props":1594,"children":1595},{},[1596,1598],{"type":50,"value":1597},"Markdown links: ",{"type":45,"tag":53,"props":1599,"children":1601},{"className":1600},[],[1602],{"type":50,"value":1603},"](old\u002Fpath\u002Fpage.md",{"type":45,"tag":78,"props":1605,"children":1606},{},[1607,1609],{"type":50,"value":1608},"Cross-links from other repos: ",{"type":45,"tag":53,"props":1610,"children":1612},{"className":1611},[],[1613],{"type":50,"value":1614},"repo-name:\u002F\u002Fold\u002Fpath\u002Fpage.md",{"type":45,"tag":78,"props":1616,"children":1617},{},[1618],{"type":50,"value":1619},"Toctree entries referencing the old path",{"type":45,"tag":78,"props":1621,"children":1622},{},[1623,1628],{"type":45,"tag":143,"props":1624,"children":1625},{},[1626],{"type":50,"value":1627},"Report",{"type":50,"value":1629},": Summarize what was done — redirects added and links updated.",{"type":45,"tag":62,"props":1631,"children":1633},{"id":1632},"validation",[1634],{"type":50,"value":1635},"Validation",{"type":45,"tag":46,"props":1637,"children":1638},{},[1639,1641,1647],{"type":50,"value":1640},"Run ",{"type":45,"tag":53,"props":1642,"children":1644},{"className":1643},[],[1645],{"type":50,"value":1646},"docs-builder diff validate",{"type":50,"value":1648}," locally to verify all necessary redirect rules are in place after your changes. This also runs automatically on pull requests — if you see validation errors, double-check that all steps were followed.",{"type":45,"tag":62,"props":1650,"children":1652},{"id":1651},"guidelines",[1653],{"type":50,"value":1654},"Guidelines",{"type":45,"tag":74,"props":1656,"children":1657},{},[1658,1663,1668,1673,1678],{"type":45,"tag":78,"props":1659,"children":1660},{},[1661],{"type":50,"value":1662},"Always use single quotes around paths in YAML to avoid escaping issues.",{"type":45,"tag":78,"props":1664,"children":1665},{},[1666],{"type":50,"value":1667},"Keep entries sorted alphabetically by old path for readability.",{"type":45,"tag":78,"props":1669,"children":1670},{},[1671],{"type":50,"value":1672},"When deleting a page, the redirect is mandatory — never leave a published URL without a redirect.",{"type":45,"tag":78,"props":1674,"children":1675},{},[1676],{"type":50,"value":1677},"When moving multiple pages (e.g., restructuring a folder), add a redirect for each moved page.",{"type":45,"tag":78,"props":1679,"children":1680},{},[1681],{"type":50,"value":1682},"If unsure whether a redirect is needed, it's safer to add one.",{"type":45,"tag":1684,"props":1685,"children":1686},"style",{},[1687],{"type":50,"value":1688},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1690,"total":1062},[1691,1703,1716,1726,1735,1747,1757],{"slug":1692,"name":1692,"fn":1693,"description":1694,"org":1695,"tags":1696,"stars":20,"repoUrl":21,"updatedAt":1702},"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},[1697,1698,1699],{"name":17,"slug":18,"type":15},{"name":9,"slug":8,"type":15},{"name":1700,"slug":1701,"type":15},"Technical Writing","technical-writing","2026-07-12T07:50:42.801473",{"slug":1704,"name":1704,"fn":1705,"description":1706,"org":1707,"tags":1708,"stars":20,"repoUrl":21,"updatedAt":1715},"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},[1709,1712,1713,1714],{"name":1710,"slug":1711,"type":15},"Accessibility","accessibility",{"name":17,"slug":18,"type":15},{"name":9,"slug":8,"type":15},{"name":1700,"slug":1701,"type":15},"2026-07-12T07:49:36.112751",{"slug":1717,"name":1717,"fn":1718,"description":1719,"org":1720,"tags":1721,"stars":20,"repoUrl":21,"updatedAt":1725},"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},[1722,1723,1724],{"name":17,"slug":18,"type":15},{"name":9,"slug":8,"type":15},{"name":1700,"slug":1701,"type":15},"2026-07-12T07:50:36.826563",{"slug":1727,"name":1727,"fn":1728,"description":1729,"org":1730,"tags":1731,"stars":20,"repoUrl":21,"updatedAt":1734},"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},[1732,1733],{"name":17,"slug":18,"type":15},{"name":1700,"slug":1701,"type":15},"2026-07-12T07:48:02.16095",{"slug":1736,"name":1736,"fn":1737,"description":1738,"org":1739,"tags":1740,"stars":20,"repoUrl":21,"updatedAt":1746},"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},[1741,1742,1743,1744],{"name":17,"slug":18,"type":15},{"name":9,"slug":8,"type":15},{"name":1700,"slug":1701,"type":15},{"name":1745,"slug":180,"type":15},"YAML","2026-07-12T07:48:58.570382",{"slug":1748,"name":1748,"fn":1749,"description":1750,"org":1751,"tags":1752,"stars":20,"repoUrl":21,"updatedAt":1756},"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},[1753,1754,1755],{"name":17,"slug":18,"type":15},{"name":9,"slug":8,"type":15},{"name":1700,"slug":1701,"type":15},"2026-07-12T07:49:34.836748",{"slug":1758,"name":1758,"fn":1759,"description":1760,"org":1761,"tags":1762,"stars":20,"repoUrl":21,"updatedAt":1769},"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},[1763,1766,1767,1768],{"name":1764,"slug":1765,"type":15},"Audit","audit",{"name":17,"slug":18,"type":15},{"name":9,"slug":8,"type":15},{"name":1700,"slug":1701,"type":15},"2026-07-12T07:49:39.883351",{"items":1771,"total":1941},[1772,1791,1808,1823,1842,1854,1864,1879,1891,1904,1915,1928],{"slug":1773,"name":1773,"fn":1774,"description":1775,"org":1776,"tags":1777,"stars":1788,"repoUrl":1789,"updatedAt":1790},"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},[1778,1781,1784,1785],{"name":1779,"slug":1780,"type":15},"Analytics","analytics",{"name":1782,"slug":1783,"type":15},"Data Analysis","data-analysis",{"name":9,"slug":8,"type":15},{"name":1786,"slug":1787,"type":15},"Performance","performance",2027,"https:\u002F\u002Fgithub.com\u002Felastic\u002Frally","2026-07-12T07:46:38.54144",{"slug":1792,"name":1792,"fn":1793,"description":1794,"org":1795,"tags":1796,"stars":1788,"repoUrl":1789,"updatedAt":1807},"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},[1797,1800,1801,1804],{"name":1798,"slug":1799,"type":15},"Debugging","debugging",{"name":9,"slug":8,"type":15},{"name":1802,"slug":1803,"type":15},"Engineering","engineering",{"name":1805,"slug":1806,"type":15},"Local Development","local-development","2026-07-12T07:46:35.976807",{"slug":1809,"name":1809,"fn":1810,"description":1811,"org":1812,"tags":1813,"stars":1788,"repoUrl":1789,"updatedAt":1822},"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},[1814,1815,1818,1819],{"name":9,"slug":8,"type":15},{"name":1816,"slug":1817,"type":15},"Elasticsearch","elasticsearch",{"name":1786,"slug":1787,"type":15},{"name":1820,"slug":1821,"type":15},"Testing","testing","2026-07-12T07:46:37.277964",{"slug":1824,"name":1824,"fn":1825,"description":1826,"org":1827,"tags":1828,"stars":1839,"repoUrl":1840,"updatedAt":1841},"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},[1829,1832,1833,1836],{"name":1830,"slug":1831,"type":15},"Cloud","cloud",{"name":9,"slug":8,"type":15},{"name":1834,"slug":1835,"type":15},"Operations","operations",{"name":1837,"slug":1838,"type":15},"Permissions","permissions",531,"https:\u002F\u002Fgithub.com\u002Felastic\u002Fagent-skills","2026-07-12T07:46:44.946285",{"slug":1843,"name":1843,"fn":1844,"description":1845,"org":1846,"tags":1847,"stars":1839,"repoUrl":1840,"updatedAt":1853},"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},[1848,1849,1852],{"name":1830,"slug":1831,"type":15},{"name":1850,"slug":1851,"type":15},"Deployment","deployment",{"name":1816,"slug":1817,"type":15},"2026-07-12T07:46:42.353362",{"slug":1855,"name":1855,"fn":1856,"description":1857,"org":1858,"tags":1859,"stars":1839,"repoUrl":1840,"updatedAt":1863},"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},[1860,1861,1862],{"name":1830,"slug":1831,"type":15},{"name":1816,"slug":1817,"type":15},{"name":1834,"slug":1835,"type":15},"2026-07-12T07:46:41.097412",{"slug":1865,"name":1865,"fn":1866,"description":1867,"org":1868,"tags":1869,"stars":1839,"repoUrl":1840,"updatedAt":1878},"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},[1870,1871,1872,1875],{"name":1830,"slug":1831,"type":15},{"name":1816,"slug":1817,"type":15},{"name":1873,"slug":1874,"type":15},"Networking","networking",{"name":1876,"slug":1877,"type":15},"Security","security","2026-07-12T07:46:43.675992",{"slug":1880,"name":1880,"fn":1881,"description":1882,"org":1883,"tags":1884,"stars":1839,"repoUrl":1840,"updatedAt":1890},"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},[1885,1888,1889],{"name":1886,"slug":1887,"type":15},"Authentication","authentication",{"name":1830,"slug":1831,"type":15},{"name":1816,"slug":1817,"type":15},"2026-07-12T07:46:39.783105",{"slug":1892,"name":1892,"fn":1893,"description":1894,"org":1895,"tags":1896,"stars":1839,"repoUrl":1840,"updatedAt":1903},"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},[1897,1898,1899,1902],{"name":1764,"slug":1765,"type":15},{"name":1816,"slug":1817,"type":15},{"name":1900,"slug":1901,"type":15},"Logs","logs",{"name":1876,"slug":1877,"type":15},"2026-07-12T07:47:35.092599",{"slug":1905,"name":1905,"fn":1906,"description":1907,"org":1908,"tags":1909,"stars":1839,"repoUrl":1840,"updatedAt":1914},"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},[1910,1911,1912,1913],{"name":1886,"slug":1887,"type":15},{"name":9,"slug":8,"type":15},{"name":1816,"slug":1817,"type":15},{"name":1876,"slug":1877,"type":15},"2026-07-12T07:47:41.474547",{"slug":1916,"name":1916,"fn":1917,"description":1918,"org":1919,"tags":1920,"stars":1839,"repoUrl":1840,"updatedAt":1927},"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},[1921,1922,1923,1926],{"name":9,"slug":8,"type":15},{"name":1816,"slug":1817,"type":15},{"name":1924,"slug":1925,"type":15},"RBAC","rbac",{"name":1876,"slug":1877,"type":15},"2026-07-12T07:47:36.394177",{"slug":1929,"name":1929,"fn":1930,"description":1931,"org":1932,"tags":1933,"stars":1839,"repoUrl":1840,"updatedAt":1940},"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},[1934,1935,1936,1937],{"name":1779,"slug":1780,"type":15},{"name":1782,"slug":1783,"type":15},{"name":1816,"slug":1817,"type":15},{"name":1938,"slug":1939,"type":15},"SQL","sql","2026-07-12T07:47:40.249533",86]