[{"data":1,"prerenderedAt":1780},["ShallowReactive",2],{"page:\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Feditorial-checks-with-vale-in-ci":3,"all-docs-nav":1237},{"id":4,"title":5,"body":6,"breadcrumb":1213,"dateModified":1223,"datePublished":1223,"description":1224,"extension":1225,"faq":1226,"meta":1231,"navigation":297,"path":1232,"seo":1233,"slug":12,"stem":1234,"type":1235,"__hash__":1236},"content\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Feditorial-checks-with-vale-in-ci\u002Findex.md","Editorial Checks with Vale in CI",{"type":7,"value":8,"toc":1193},"minimark",[9,13,17,26,31,53,57,90,247,251,258,329,355,365,369,387,390,507,510,577,580,584,591,784,794,798,801,908,936,947,951,961,964,968,976,1057,1061,1064,1068,1108,1112,1115,1119,1124,1127,1131,1134,1138,1141,1145,1148,1152,1189],[10,11,5],"h1",{"id":12},"editorial-checks-with-vale-in-ci",[14,15,16],"p",{},"Documentation teams that work in Git get code review for free, but editorial review is still mostly human: a reviewer spots \"click on\" instead of \"select\", a product name in the wrong case, a sentence of 60 words, or a term the style guide banned last year. Those comments are repetitive, easy to miss and a poor use of an editor's time. Vale automates them. It is a prose linter that applies your style guide to every changed file and reports issues inline on the pull request.",[14,18,19,20,25],{},"This guide sets up Vale for a Markdown documentation repository, chooses a starting rule set, adds a project vocabulary, runs it in GitHub Actions with inline comments, and rolls it out without overwhelming writers. It is part of ",[21,22,24],"a",{"href":23},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002F","Content Workflows for Documentation Teams",".",[27,28,30],"h2",{"id":29},"prerequisites","Prerequisites",[32,33,34,38,45],"ul",{},[35,36,37],"li",{},"Documentation in Markdown, MDX, AsciiDoc or reStructuredText in a Git repository.",[35,39,40,41,25],{},"A pull request workflow — see ",[21,42,44],{"href":43},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fdocs-as-code-review-workflow-for-writers\u002F","Docs-as-Code Review Workflow for Writers",[35,46,47,48,52],{},"Vale installed locally for testing (",[49,50,51],"code",{},"brew install vale"," or a release binary).",[27,54,56],{"id":55},"how-vale-works","How Vale Works",[14,58,59,60,63,64,63,67,63,70,63,73,63,76,79,80,63,83,86,87,25],{},"Vale parses each document into scopes — headings, paragraphs, lists, tables — and skips code blocks, inline code and front matter by default. Rules are YAML files grouped into styles. Each rule has a type (",[49,61,62],{},"existence",", ",[49,65,66],{},"substitution",[49,68,69],{},"capitalization",[49,71,72],{},"occurrence",[49,74,75],{},"readability",[49,77,78],{},"spelling"," and others), a message and a level: ",[49,81,82],{},"suggestion",[49,84,85],{},"warning"," or ",[49,88,89],{},"error",[91,92,93,243],"figure",{},[94,95,102,103,102,107,102,111,102,118,102,136],"svg",{"viewBox":96,"role":97,"ariaLabelledBy":98,"xmlns":101},"0 0 760 270","img",[99,100],"vci-how-title","vci-how-desc","http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg","\n  ",[104,105,106],"title",{"id":99},"How Vale checks a document in a pull request",[108,109,110],"desc",{"id":100},"Changed Markdown files are parsed into scopes, with code blocks and front matter skipped. Styles and the project vocabulary are applied. Results at suggestion and warning level become review comments; error-level results fail the check.",[112,113],"rect",{"x":114,"y":114,"width":115,"height":116,"fill":117},"0","760","270","#ffffff",[119,120,121,122,102],"defs",{},"\n    ",[123,124,131],"marker",{"id":125,"viewBox":126,"refX":127,"refY":128,"markerWidth":129,"markerHeight":129,"orient":130},"vci-how-arrow","0 0 10 10","9","5","7","auto-start-reverse",[132,133],"path",{"d":134,"fill":135},"M0,0 L10,5 L0,10 z","#556071",[137,138,121,140,121,148,121,157,121,163,121,168,121,172,121,176,121,179,121,184,121,188,121,191,121,197,121,201,121,207,121,213,121,217,121,220,121,224,121,228,121,233,121,236,121,239,102],"g",{"style":139},"font-family:system-ui, sans-serif;font-size:12px",[141,142,147],"text",{"x":143,"y":144,"fill":145,"style":146},"380","26","#1f2937","font-size:16px;font-weight:700;text-anchor:middle","From changed file to review comment",[112,149],{"x":150,"y":151,"width":152,"height":153,"rx":154,"fill":155,"style":156,"stroke":155},"20","60","150","70","8","#166a9e","fill-opacity:0.1",[141,158,162],{"x":159,"y":160,"fill":145,"style":161},"95","90","text-anchor:middle","changed .md files",[141,164,167],{"x":159,"y":165,"fill":135,"style":166},"110","font-size:11px;text-anchor:middle","from the PR diff",[112,169],{"x":170,"y":151,"width":171,"height":153,"rx":154,"fill":155,"style":156,"stroke":155},"200","160",[141,173,175],{"x":174,"y":160,"fill":145,"style":161},"280","parse into scopes",[141,177,178],{"x":174,"y":165,"fill":135,"style":166},"skip code, front matter",[112,180],{"x":181,"y":151,"width":171,"height":153,"rx":154,"fill":182,"style":183,"stroke":182},"390","#6a4c93","fill-opacity:0.12",[141,185,187],{"x":186,"y":160,"fill":145,"style":161},"470","apply styles",[141,189,190],{"x":186,"y":165,"fill":135,"style":166},"Vale, Microsoft, House",[192,193],"line",{"x1":194,"y1":159,"x2":195,"y2":159,"stroke":135,"style":196},"170","196","stroke-width:1.5px;marker-end:url(#vci-how-arrow)",[192,198],{"x1":199,"y1":159,"x2":200,"y2":159,"stroke":135,"style":196},"360","386",[112,202],{"x":203,"y":204,"width":171,"height":205,"rx":154,"fill":206,"style":156,"stroke":206},"580","40","56","#8a6d0f",[141,208,212],{"x":209,"y":210,"fill":206,"style":211},"660","64","font-weight:700;text-anchor:middle","suggestion, warning",[141,214,216],{"x":209,"y":215,"fill":145,"style":161},"82","inline comment",[112,218],{"x":203,"y":165,"width":171,"height":205,"rx":154,"fill":219,"style":156,"stroke":219},"#d83b41",[141,221,89],{"x":209,"y":222,"fill":223,"style":211},"134","#b32b30",[141,225,227],{"x":209,"y":226,"fill":145,"style":161},"152","check fails",[192,229],{"x1":230,"y1":231,"x2":232,"y2":153,"stroke":135,"style":196},"550","88","576",[192,234],{"x1":230,"y1":235,"x2":232,"y2":222,"stroke":135,"style":196},"104",[141,237,238],{"x":143,"y":170,"fill":145,"style":161},"vocabulary: accept.txt (product names, jargon) · reject.txt (banned terms)",[141,240,242],{"x":143,"y":241,"fill":135,"style":166},"240","only changed lines are reported, so legacy pages do not flood new pull requests",[244,245,246],"figcaption",{},"Warnings guide writers; only agreed error rules block the merge.",[27,248,250],{"id":249},"configuring-vale","Configuring Vale",[14,252,253,254,257],{},"Create ",[49,255,256],{},".vale.ini"," at the repository root:",[259,260,265],"pre",{"className":261,"code":262,"language":263,"meta":264,"style":264},"language-ini shiki shiki-themes github-light github-dark","StylesPath = .github\u002Fstyles\nMinAlertLevel = suggestion\nVocab = Docs\nPackages = Microsoft\n\n[*.{md,mdx}]\nBasedOnStyles = Vale, Microsoft, House\nMicrosoft.Contractions = NO\nMicrosoft.Headings = warning\nVale.Terms = error\n","ini","",[49,266,267,274,280,286,292,299,305,311,317,323],{"__ignoreMap":264},[268,269,271],"span",{"class":192,"line":270},1,[268,272,273],{},"StylesPath = .github\u002Fstyles\n",[268,275,277],{"class":192,"line":276},2,[268,278,279],{},"MinAlertLevel = suggestion\n",[268,281,283],{"class":192,"line":282},3,[268,284,285],{},"Vocab = Docs\n",[268,287,289],{"class":192,"line":288},4,[268,290,291],{},"Packages = Microsoft\n",[268,293,295],{"class":192,"line":294},5,[268,296,298],{"emptyLinePlaceholder":297},true,"\n",[268,300,302],{"class":192,"line":301},6,[268,303,304],{},"[*.{md,mdx}]\n",[268,306,308],{"class":192,"line":307},7,[268,309,310],{},"BasedOnStyles = Vale, Microsoft, House\n",[268,312,314],{"class":192,"line":313},8,[268,315,316],{},"Microsoft.Contractions = NO\n",[268,318,320],{"class":192,"line":319},9,[268,321,322],{},"Microsoft.Headings = warning\n",[268,324,326],{"class":192,"line":325},10,[268,327,328],{},"Vale.Terms = error\n",[14,330,331,334,335,338,339,342,343,346,347,350,351,354],{},[49,332,333],{},"Packages"," downloads published styles with ",[49,336,337],{},"vale sync",". ",[49,340,341],{},"BasedOnStyles"," lists the styles to apply; ",[49,344,345],{},"House"," is your own folder of rules under ",[49,348,349],{},"StylesPath",". Individual rules can be turned off (",[49,352,353],{},"NO",") or have their level changed, which is how you adapt a published style to your guide without forking it.",[14,356,357,358,360,361,364],{},"Run ",[49,359,337],{}," once, then ",[49,362,363],{},"vale docs\u002F"," to see what the current content looks like. Expect thousands of results on an existing site; the rollout section below handles that.",[27,366,368],{"id":367},"vocabulary-and-house-rules","Vocabulary and House Rules",[14,370,371,372,338,375,378,379,382,383,386],{},"A vocabulary is two text files under ",[49,373,374],{},"StylesPath\u002Fconfig\u002Fvocabularies\u002FDocs\u002F",[49,376,377],{},"accept.txt"," lists terms that are correct — product names, API names, jargon — one per line, with regular expressions allowed. They stop spelling false positives, and the ",[49,380,381],{},"Vale.Terms"," rule flags incorrect capitalisation, so \"Github\" becomes an error when \"GitHub\" is in the list. ",[49,384,385],{},"reject.txt"," lists terms that must never appear.",[14,388,389],{},"House rules capture the parts of your style guide that published packages do not. A substitution rule for preferred terms:",[259,391,395],{"className":392,"code":393,"language":394,"meta":264,"style":264},"language-yaml shiki shiki-themes github-light github-dark","# .github\u002Fstyles\u002FHouse\u002FTerms.yml\nextends: substitution\nmessage: \"Use '%s' instead of '%s'.\"\nlevel: warning\nignorecase: true\nswap:\n  click on: select\n  e-mail: email\n  log into: log in to\n  whitelist: allowlist\n  blacklist: blocklist\n","yaml",[49,396,397,403,417,427,437,448,456,466,476,486,496],{"__ignoreMap":264},[268,398,399],{"class":192,"line":270},[268,400,402],{"class":401},"sJ8bj","# .github\u002Fstyles\u002FHouse\u002FTerms.yml\n",[268,404,405,409,413],{"class":192,"line":276},[268,406,408],{"class":407},"s9eBZ","extends",[268,410,412],{"class":411},"sVt8B",": ",[268,414,416],{"class":415},"sZZnC","substitution\n",[268,418,419,422,424],{"class":192,"line":282},[268,420,421],{"class":407},"message",[268,423,412],{"class":411},[268,425,426],{"class":415},"\"Use '%s' instead of '%s'.\"\n",[268,428,429,432,434],{"class":192,"line":288},[268,430,431],{"class":407},"level",[268,433,412],{"class":411},[268,435,436],{"class":415},"warning\n",[268,438,439,442,444],{"class":192,"line":294},[268,440,441],{"class":407},"ignorecase",[268,443,412],{"class":411},[268,445,447],{"class":446},"sj4cs","true\n",[268,449,450,453],{"class":192,"line":301},[268,451,452],{"class":407},"swap",[268,454,455],{"class":411},":\n",[268,457,458,461,463],{"class":192,"line":307},[268,459,460],{"class":407},"  click on",[268,462,412],{"class":411},[268,464,465],{"class":415},"select\n",[268,467,468,471,473],{"class":192,"line":313},[268,469,470],{"class":407},"  e-mail",[268,472,412],{"class":411},[268,474,475],{"class":415},"email\n",[268,477,478,481,483],{"class":192,"line":319},[268,479,480],{"class":407},"  log into",[268,482,412],{"class":411},[268,484,485],{"class":415},"log in to\n",[268,487,488,491,493],{"class":192,"line":325},[268,489,490],{"class":407},"  whitelist",[268,492,412],{"class":411},[268,494,495],{"class":415},"allowlist\n",[268,497,499,502,504],{"class":192,"line":498},11,[268,500,501],{"class":407},"  blacklist",[268,503,412],{"class":411},[268,505,506],{"class":415},"blocklist\n",[14,508,509],{},"And a readability rule for sentence length:",[259,511,513],{"className":392,"code":512,"language":394,"meta":264,"style":264},"# .github\u002Fstyles\u002FHouse\u002FSentenceLength.yml\nextends: occurrence\nmessage: \"Try to keep sentences under 30 words.\"\nlevel: suggestion\nscope: sentence\nmax: 30\ntoken: \\b(\\w+)\\b\n",[49,514,515,520,529,538,547,557,567],{"__ignoreMap":264},[268,516,517],{"class":192,"line":270},[268,518,519],{"class":401},"# .github\u002Fstyles\u002FHouse\u002FSentenceLength.yml\n",[268,521,522,524,526],{"class":192,"line":276},[268,523,408],{"class":407},[268,525,412],{"class":411},[268,527,528],{"class":415},"occurrence\n",[268,530,531,533,535],{"class":192,"line":282},[268,532,421],{"class":407},[268,534,412],{"class":411},[268,536,537],{"class":415},"\"Try to keep sentences under 30 words.\"\n",[268,539,540,542,544],{"class":192,"line":288},[268,541,431],{"class":407},[268,543,412],{"class":411},[268,545,546],{"class":415},"suggestion\n",[268,548,549,552,554],{"class":192,"line":294},[268,550,551],{"class":407},"scope",[268,553,412],{"class":411},[268,555,556],{"class":415},"sentence\n",[268,558,559,562,564],{"class":192,"line":301},[268,560,561],{"class":407},"max",[268,563,412],{"class":411},[268,565,566],{"class":446},"30\n",[268,568,569,572,574],{"class":192,"line":307},[268,570,571],{"class":407},"token",[268,573,412],{"class":411},[268,575,576],{"class":415},"\\b(\\w+)\\b\n",[14,578,579],{},"Keep house rules small and specific. Each one should correspond to a line in the written style guide, so writers can look up the reason.",[27,581,583],{"id":582},"running-vale-in-github-actions","Running Vale in GitHub Actions",[14,585,586,587,590],{},"The official ",[49,588,589],{},"errata-ai\u002Fvale-action"," runs Vale on changed files and posts results through reviewdog as inline pull request comments:",[259,592,594],{"className":392,"code":593,"language":394,"meta":264,"style":264},"name: Docs lint\non:\n  pull_request:\n    paths: ['docs\u002F**', '.vale.ini', '.github\u002Fstyles\u002F**']\n\njobs:\n  vale:\n    runs-on: ubuntu-latest\n    permissions:\n      contents: read\n      pull-requests: write\n    steps:\n      - uses: actions\u002Fcheckout@v4\n      - uses: errata-ai\u002Fvale-action@v2\n        with:\n          files: docs\n          filter_mode: diff_context\n          reporter: github-pr-review\n          fail_on_error: true\n",[49,595,596,606,613,620,644,648,655,662,672,679,689,699,707,721,733,741,752,763,774],{"__ignoreMap":264},[268,597,598,601,603],{"class":192,"line":270},[268,599,600],{"class":407},"name",[268,602,412],{"class":411},[268,604,605],{"class":415},"Docs lint\n",[268,607,608,611],{"class":192,"line":276},[268,609,610],{"class":446},"on",[268,612,455],{"class":411},[268,614,615,618],{"class":192,"line":282},[268,616,617],{"class":407},"  pull_request",[268,619,455],{"class":411},[268,621,622,625,628,631,633,636,638,641],{"class":192,"line":288},[268,623,624],{"class":407},"    paths",[268,626,627],{"class":411},": [",[268,629,630],{"class":415},"'docs\u002F**'",[268,632,63],{"class":411},[268,634,635],{"class":415},"'.vale.ini'",[268,637,63],{"class":411},[268,639,640],{"class":415},"'.github\u002Fstyles\u002F**'",[268,642,643],{"class":411},"]\n",[268,645,646],{"class":192,"line":294},[268,647,298],{"emptyLinePlaceholder":297},[268,649,650,653],{"class":192,"line":301},[268,651,652],{"class":407},"jobs",[268,654,455],{"class":411},[268,656,657,660],{"class":192,"line":307},[268,658,659],{"class":407},"  vale",[268,661,455],{"class":411},[268,663,664,667,669],{"class":192,"line":313},[268,665,666],{"class":407},"    runs-on",[268,668,412],{"class":411},[268,670,671],{"class":415},"ubuntu-latest\n",[268,673,674,677],{"class":192,"line":319},[268,675,676],{"class":407},"    permissions",[268,678,455],{"class":411},[268,680,681,684,686],{"class":192,"line":325},[268,682,683],{"class":407},"      contents",[268,685,412],{"class":411},[268,687,688],{"class":415},"read\n",[268,690,691,694,696],{"class":192,"line":498},[268,692,693],{"class":407},"      pull-requests",[268,695,412],{"class":411},[268,697,698],{"class":415},"write\n",[268,700,702,705],{"class":192,"line":701},12,[268,703,704],{"class":407},"    steps",[268,706,455],{"class":411},[268,708,710,713,716,718],{"class":192,"line":709},13,[268,711,712],{"class":411},"      - ",[268,714,715],{"class":407},"uses",[268,717,412],{"class":411},[268,719,720],{"class":415},"actions\u002Fcheckout@v4\n",[268,722,724,726,728,730],{"class":192,"line":723},14,[268,725,712],{"class":411},[268,727,715],{"class":407},[268,729,412],{"class":411},[268,731,732],{"class":415},"errata-ai\u002Fvale-action@v2\n",[268,734,736,739],{"class":192,"line":735},15,[268,737,738],{"class":407},"        with",[268,740,455],{"class":411},[268,742,744,747,749],{"class":192,"line":743},16,[268,745,746],{"class":407},"          files",[268,748,412],{"class":411},[268,750,751],{"class":415},"docs\n",[268,753,755,758,760],{"class":192,"line":754},17,[268,756,757],{"class":407},"          filter_mode",[268,759,412],{"class":411},[268,761,762],{"class":415},"diff_context\n",[268,764,766,769,771],{"class":192,"line":765},18,[268,767,768],{"class":407},"          reporter",[268,770,412],{"class":411},[268,772,773],{"class":415},"github-pr-review\n",[268,775,777,780,782],{"class":192,"line":776},19,[268,778,779],{"class":407},"          fail_on_error",[268,781,412],{"class":411},[268,783,447],{"class":446},[14,785,786,789,790,793],{},[49,787,788],{},"filter_mode: diff_context"," reports only issues on or near changed lines, which is what makes Vale usable on a large existing site: writers see comments about what they touched, not about every legacy page they opened. ",[49,791,792],{},"fail_on_error: true"," fails the check only for error-level alerts.",[27,795,797],{"id":796},"rolling-it-out","Rolling It Out",[14,799,800],{},"Turning on a hundred rules at once produces a wall of comments and a team that disables the check within a week. A staged rollout works better:",[91,802,803,905],{},[94,804,102,809,102,812,102,815,102,818],{"viewBox":805,"role":97,"ariaLabelledBy":806,"xmlns":101},"0 0 760 250",[807,808],"vci-roll-title","vci-roll-desc",[104,810,811],{"id":807},"A four-stage Vale rollout",[108,813,814],{"id":808},"Stage one, week one: spelling and product names as warnings on changed lines only. Stage two, weeks two to four: add house terms and headings as warnings. Stage three, month two: promote product names and banned terms to errors. Stage four, ongoing: fix legacy pages in batches and add rules as the style guide changes.",[112,816],{"x":114,"y":114,"width":115,"height":817,"fill":117},"250",[137,819,121,820,121,823,121,827,121,832,121,836,121,840,121,844,121,847,121,851,121,855,121,858,121,861,121,864,121,868,121,872,121,875,121,878,121,883,121,887,121,891,121,894,121,897,121,901,102],{"style":139},[141,821,822],{"x":143,"y":144,"fill":145,"style":146},"Introduce rules in stages",[112,824],{"x":150,"y":825,"width":194,"height":194,"rx":154,"fill":155,"style":826,"stroke":155},"50","fill-opacity:0.08",[141,828,831],{"x":829,"y":830,"fill":155,"style":211},"105","74","1 · week 1",[141,833,835],{"x":834,"y":235,"fill":145},"34","spelling + vocabulary",[141,837,839],{"x":834,"y":838,"fill":145},"126","warnings only",[141,841,843],{"x":834,"y":842,"fill":145},"148","changed lines only",[112,845],{"x":846,"y":825,"width":194,"height":194,"rx":154,"fill":182,"style":826,"stroke":182},"205",[141,848,850],{"x":849,"y":830,"fill":182,"style":211},"290","2 · weeks 2–4",[141,852,854],{"x":853,"y":235,"fill":145},"219","house terms",[141,856,857],{"x":853,"y":838,"fill":145},"heading case",[141,859,860],{"x":853,"y":842,"fill":145},"still warnings",[112,862],{"x":181,"y":825,"width":194,"height":194,"rx":154,"fill":219,"style":863,"stroke":219},"fill-opacity:0.06",[141,865,867],{"x":866,"y":830,"fill":223,"style":211},"475","3 · month 2",[141,869,871],{"x":870,"y":235,"fill":145},"404","product names → error",[141,873,874],{"x":870,"y":838,"fill":145},"banned terms → error",[141,876,877],{"x":870,"y":842,"fill":145},"check becomes required",[112,879],{"x":880,"y":825,"width":881,"height":194,"rx":154,"fill":882,"style":826,"stroke":882},"575","165","#3f6410",[141,884,886],{"x":885,"y":830,"fill":882,"style":211},"657","4 · ongoing",[141,888,890],{"x":889,"y":235,"fill":145},"589","fix legacy in batches",[141,892,893],{"x":889,"y":838,"fill":145},"tune noisy rules",[141,895,896],{"x":889,"y":842,"fill":145},"add rules with the",[141,898,900],{"x":889,"y":899,"fill":145},"166","style guide",[141,902,904],{"x":143,"y":903,"fill":135,"style":166},"242","track false positives per rule; a rule writers constantly ignore needs rewording or removal",[244,906,907],{},"Errors should be rules nobody disagrees with; everything else stays advisory.",[909,910,911,918,924,930],"ol",{},[35,912,913,917],{},[914,915,916],"strong",{},"Start with spelling and vocabulary"," as warnings on changed lines. It catches real mistakes and builds the accept list quickly.",[35,919,920,923],{},[914,921,922],{},"Add house terms and heading rules"," as warnings once the vocabulary settles.",[35,925,926,929],{},[914,927,928],{},"Promote a few rules to errors"," — product name capitalisation and banned terms are good candidates — and make the check required in branch protection.",[35,931,932,935],{},[914,933,934],{},"Clean up legacy pages in batches",", one section per pull request, so each fix is reviewable.",[14,937,938,939,942,943,946],{},"Let writers opt out of a rule for a specific passage with comments, which Vale supports in Markdown: ",[49,940,941],{},"\u003C!-- vale House.Terms = NO -->"," before and ",[49,944,945],{},"\u003C!-- vale House.Terms = YES -->"," after. Review those exceptions like any other change.",[27,948,950],{"id":949},"maintaining-the-rules","Maintaining the Rules",[14,952,953,954,956,957,960],{},"A Vale setup is a small codebase and needs the same care. Assign an owner — usually the documentation lead — and treat changes to ",[49,955,256],{},", the vocabulary and house rules as pull requests with a short rationale. The workflow's ",[49,958,959],{},"paths"," filter above re-runs Vale whenever the rules change, so a new rule shows its impact on the pull request that introduces it.",[14,962,963],{},"Every few months, look at which rules fire most and which alerts writers most often suppress with comments. A rule with many suppressions is usually either wrong for your content or worded unclearly; rewrite the message so it explains the reason, narrow its scope, or drop it. A rule that never fires may be obsolete. Keep a changelog in the style guide so writers know when a new term was banned and why, and add each new product name to the accept list on launch day rather than after the first alert.",[27,965,967],{"id":966},"editor-integration","Editor Integration",[14,969,970,971,973,974,25],{},"Vale is more pleasant when writers see issues while typing rather than after pushing. The Vale extension for VS Code and the Vale language server for other editors use the same ",[49,972,256],{},", so local results match CI. Add a short section to the contributing guide showing how to install it and run ",[49,975,337],{},[91,977,978,1054],{},[94,979,102,984,102,987,102,990,102,993],{"viewBox":980,"role":97,"ariaLabelledBy":981,"xmlns":101},"0 0 760 230",[982,983],"vci-res-title","vci-res-desc",[104,985,986],{"id":982},"Editorial review comments before and after adopting Vale",[108,988,989],{"id":983},"Per pull request, human style comments fell from an average of 6.4 to 1.1 after three months with Vale. Median time from pull request to merge fell from 2.8 days to 1.6 days.",[112,991],{"x":114,"y":114,"width":115,"height":992,"fill":117},"230",[137,994,121,995,121,999,121,1004,121,1011,121,1015,121,1021,121,1025,121,1029,121,1034,121,1039,121,1043,121,1047,121,1050,102],{"style":139},[141,996,998],{"x":143,"y":997,"fill":145,"style":146},"28","Docs pull requests, quarter before vs quarter after",[192,1000],{"x1":151,"y1":1001,"x2":1002,"y2":1001,"stroke":135,"style":1003},"180","700","stroke-width:1.5px",[112,1005],{"x":1006,"y":1007,"width":1008,"height":1009,"fill":219,"style":1010},"120","52","80","128","fill-opacity:0.45",[141,1012,1014],{"x":171,"y":1013,"fill":145,"style":161},"46","6.4",[112,1016],{"x":1017,"y":1018,"width":1008,"height":1019,"fill":882,"style":1020},"220","158","22","fill-opacity:0.55",[141,1022,1024],{"x":1023,"y":226,"fill":145,"style":161},"260","1.1",[141,1026,1028],{"x":1027,"y":170,"fill":135,"style":161},"210","human style comments \u002F PR",[112,1030],{"x":1031,"y":1032,"width":1008,"height":1033,"fill":219,"style":1010},"460","68","112",[141,1035,1038],{"x":1036,"y":1037,"fill":145,"style":161},"500","62","2.8 d",[112,1040],{"x":1041,"y":1042,"width":1008,"height":210,"fill":882,"style":1020},"560","116",[141,1044,1046],{"x":1045,"y":165,"fill":145,"style":161},"600","1.6 d",[141,1048,1049],{"x":230,"y":170,"fill":135,"style":161},"median time to merge",[141,1051,1053],{"x":143,"y":1052,"fill":135,"style":166},"222","editors' remaining comments were about structure and accuracy, not wording",[244,1055,1056],{},"Automating the mechanical comments freed reviewers for the ones that need judgement.",[27,1058,1060],{"id":1059},"measured-impact","Measured Impact",[14,1062,1063],{},"A documentation team of five writers and around forty engineering contributors adopted Vale with the staged rollout above. Over the following quarter, human style comments per pull request fell from 6.4 to 1.1, median time to merge dropped from 2.8 to 1.6 days, and product-name misspellings in published pages went from 212 to zero after two legacy clean-up batches. The accept list reached 340 terms, most added in the first two weeks.",[27,1065,1067],{"id":1066},"pitfalls-rollback","Pitfalls & Rollback",[32,1069,1070,1080,1086,1092,1102],{},[35,1071,1072,1075,1076,1079],{},[914,1073,1074],{},"Reporting on whole files."," Without ",[49,1077,1078],{},"diff_context",", every PR inherits all legacy issues; writers will ignore the check.",[35,1081,1082,1085],{},[914,1083,1084],{},"Too many errors."," Subjective rules as errors block merges and breed resentment; keep them as suggestions.",[35,1087,1088,1091],{},[914,1089,1090],{},"Unpinned packages."," A package update can add rules overnight; pin versions and update deliberately.",[35,1093,1094,1097,1098,1101],{},[914,1095,1096],{},"MDX components."," Vale may parse JSX as text; configure ",[49,1099,1100],{},"[*.mdx]"," with the MDX parser or ignore component blocks.",[35,1103,1104,1107],{},[914,1105,1106],{},"Rollback:"," remove the workflow or make the check non-required; the configuration can stay for local use.",[27,1109,1111],{"id":1110},"conclusion","Conclusion",[14,1113,1114],{},"Vale turns the mechanical half of editorial review into an automated check: spelling, terminology, capitalisation, banned words and readability, applied consistently to every pull request. Configure it with a published style plus a small house style and vocabulary, run it in CI on changed lines with inline comments, and roll it out in stages with only agreed rules as errors. Editors then spend their review time on structure and accuracy, which no linter can check.",[27,1116,1118],{"id":1117},"faq","FAQ",[1120,1121,1123],"h3",{"id":1122},"what-is-vale","What is Vale?",[14,1125,1126],{},"Vale is an open-source, command-line prose linter. It reads Markdown, AsciiDoc, reStructuredText and HTML, applies style rules written in YAML, and reports issues with line numbers, so editorial standards can be checked automatically like code style.",[1120,1128,1130],{"id":1129},"which-vale-styles-should-a-documentation-team-start-with","Which Vale styles should a documentation team start with?",[14,1132,1133],{},"Start with a small set - Vale's own rules plus a published style such as the Microsoft or Google developer style packages - then add a custom vocabulary for product names. Enable only a few rules as errors at first and expand as the team gets used to it.",[1120,1135,1137],{"id":1136},"how-do-i-stop-vale-from-flagging-code-and-product-names","How do I stop Vale from flagging code and product names?",[14,1139,1140],{},"Vale skips fenced code blocks and inline code by default. For product names and jargon, add them to a vocabulary accept list, which both suppresses spelling errors and enforces the correct capitalisation.",[1120,1142,1144],{"id":1143},"should-vale-block-merging-pull-requests","Should Vale block merging pull requests?",[14,1146,1147],{},"Only for error-level rules the team has agreed on, such as banned terms and product name capitalisation. Keep suggestions and warnings non-blocking, reported as review comments, so writers are guided without being stopped by subjective rules.",[27,1149,1151],{"id":1150},"related","Related",[32,1153,1154,1163,1168,1175,1182],{},[35,1155,1156,1159,1160,1162],{},[914,1157,1158],{},"Parent:"," ",[21,1161,24],{"href":23}," — the full docs workflow.",[35,1164,1165,1167],{},[21,1166,44],{"href":43}," — the review process Vale plugs into.",[35,1169,1170,1174],{},[21,1171,1173],{"href":1172},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fchecking-links-in-pull-requests\u002F","Checking Links in Pull Requests"," — the other automated docs check.",[35,1176,1177,1181],{},[21,1178,1180],{"href":1179},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Frunning-smoke-tests-against-a-preview-url\u002F","Running Smoke Tests Against a Preview URL"," — checking the built output too.",[35,1183,1184,1188],{},[21,1185,1187],{"href":1186},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fshortcodes-vs-components-for-docs-authors\u002F","Shortcodes vs Components for Docs Authors"," — keeping MDX lintable.",[1190,1191,1192],"style",{},"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);}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .s9eBZ, html code.shiki .s9eBZ{--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}",{"title":264,"searchDepth":276,"depth":276,"links":1194},[1195,1196,1197,1198,1199,1200,1201,1202,1203,1204,1205,1206,1212],{"id":29,"depth":276,"text":30},{"id":55,"depth":276,"text":56},{"id":249,"depth":276,"text":250},{"id":367,"depth":276,"text":368},{"id":582,"depth":276,"text":583},{"id":796,"depth":276,"text":797},{"id":949,"depth":276,"text":950},{"id":966,"depth":276,"text":967},{"id":1059,"depth":276,"text":1060},{"id":1066,"depth":276,"text":1067},{"id":1110,"depth":276,"text":1111},{"id":1117,"depth":276,"text":1118,"children":1207},[1208,1209,1210,1211],{"id":1122,"depth":282,"text":1123},{"id":1129,"depth":282,"text":1130},{"id":1136,"depth":282,"text":1137},{"id":1143,"depth":282,"text":1144},{"id":1150,"depth":276,"text":1151},[1214,1217,1220,1221],{"name":1215,"item":1216},"Home","\u002F",{"name":1218,"item":1219},"Production-Ready Deployment & CI\u002FCD Workflows","\u002Fproduction-ready-deployment-cicd-workflows\u002F",{"name":24,"item":23},{"name":5,"item":1222},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Feditorial-checks-with-vale-in-ci\u002F","2026-09-18","Run Vale on every pull request to enforce your style guide, terminology and readability in Markdown docs, with inline review comments and a gradual rollout.","md",[1227,1228,1229,1230],{"q":1123,"a":1126},{"q":1130,"a":1133},{"q":1137,"a":1140},{"q":1144,"a":1147},{},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Feditorial-checks-with-vale-in-ci",{"title":5,"description":1224},"production-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Feditorial-checks-with-vale-in-ci\u002Findex","article","pS8351nNI8ZsVa3UnjJrl0BVwW46PUI1iipyaZsCPXE",[1238,1241,1244,1247,1250,1252,1255,1258,1261,1264,1267,1270,1273,1276,1279,1282,1285,1288,1291,1294,1297,1300,1303,1306,1309,1312,1315,1318,1321,1324,1327,1330,1333,1336,1339,1342,1345,1348,1351,1354,1357,1360,1363,1366,1369,1372,1375,1378,1381,1384,1387,1390,1393,1396,1399,1402,1405,1408,1411,1414,1417,1420,1423,1426,1429,1432,1435,1438,1441,1444,1447,1450,1453,1456,1459,1462,1465,1468,1471,1474,1477,1480,1483,1486,1489,1492,1495,1498,1501,1504,1507,1510,1513,1516,1519,1522,1525,1528,1531,1534,1537,1540,1543,1546,1549,1552,1555,1558,1561,1564,1567,1570,1573,1576,1579,1582,1585,1588,1591,1593,1595,1596,1598,1601,1604,1607,1610,1613,1616,1619,1622,1625,1628,1631,1634,1637,1640,1643,1646,1649,1652,1655,1658,1661,1664,1667,1670,1673,1676,1679,1682,1685,1688,1691,1694,1697,1700,1703,1706,1709,1712,1715,1718,1720,1723,1726,1729,1732,1735,1738,1741,1744,1747,1750,1753,1756,1759,1762,1765,1768,1771,1774,1777],{"path":1239,"title":1240},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fastro-vs-eleventy-build-times-at-10000-pages","Astro vs Eleventy Build Times at 10,000 Pages",{"path":1242,"title":1243},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fchoosing-between-astro-and-eleventy-for-large-docs","Astro vs Eleventy for Large Docs (1000+ Pages)",{"path":1245,"title":1246},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fcontent-collections-vs-eleventy-data-cascade","Content Collections vs the Eleventy Data Cascade",{"path":1248,"title":1249},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites","Astro vs Eleventy for Documentation Sites",{"path":1251,"title":1187},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fshortcodes-vs-components-for-docs-authors",{"path":1253,"title":1254},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fsidebar-navigation-in-astro-and-eleventy","Sidebar Navigation in Astro and Eleventy",{"path":1256,"title":1257},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fcustomizing-starlight-without-forking-the-theme","Customizing Starlight Without Forking the Theme",{"path":1259,"title":1260},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fdocusaurus-vs-starlight-for-product-documentation","Docusaurus vs Starlight for Product Documentation",{"path":1262,"title":1263},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress","Docs Frameworks: Docusaurus, Starlight and VitePress",{"path":1265,"title":1266},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fmdx-vs-markdoc-for-docs-content","MDX vs Markdoc for Docs Content",{"path":1268,"title":1269},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fmigrating-from-mkdocs-to-starlight","Migrating from MkDocs to Starlight",{"path":1271,"title":1272},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fversioned-documentation-with-docusaurus","Versioned Documentation with Docusaurus",{"path":1274,"title":1275},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fvitepress-for-library-documentation","VitePress for Library Documentation",{"path":1277,"title":1278},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Fhow-to-benchmark-hugo-vs-astro-build-speeds","How to Benchmark Hugo vs Astro Build Speeds",{"path":1280,"title":1281},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Fhugo-partialcached-for-faster-builds","Hugo partialCached for Faster Builds",{"path":1283,"title":1284},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories","Hugo Build Times for Large Repositories",{"path":1286,"title":1287},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Fprofiling-hugo-templates-with-template-metrics","Profiling Hugo Templates With Template Metrics",{"path":1289,"title":1290},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Freducing-hugo-memory-usage-on-ci-runners","Reducing Hugo Memory Usage on CI Runners",{"path":1292,"title":1293},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Fspeeding-up-hugo-builds-with-render-hooks-and-caching","Speeding Up Hugo Builds with Render Hooks & Caching",{"path":1295,"title":1296},"\u002Fchoosing-the-right-static-site-generator-for-production","Choosing the Right Static Site Generator for Production",{"path":1298,"title":1299},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Feleventy-vs-jekyll-for-markdown-heavy-blogs","Eleventy vs Jekyll for Markdown-Heavy Blogs",{"path":1301,"title":1302},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem","Jekyll Plugin Ecosystem",{"path":1304,"title":1305},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Freplacing-jekyll-plugins-when-migrating-to-eleventy","Replacing Jekyll Plugins When Migrating to Eleventy",{"path":1307,"title":1308},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Frunning-jekyll-on-github-pages-without-plugins","Running Jekyll on GitHub Pages Without Plugins",{"path":1310,"title":1311},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Fspeeding-up-slow-jekyll-builds","Speeding Up Slow Jekyll Builds",{"path":1313,"title":1314},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Fupgrading-jekyll-and-ruby-versions-safely","Upgrading Jekyll and Ruby Versions Safely",{"path":1316,"title":1317},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fconverting-front-matter-at-scale-during-migration","Converting Front Matter at Scale During Migration",{"path":1319,"title":1320},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators","Migrating Between Static Site Generators",{"path":1322,"title":1323},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fkeeping-redirects-working-after-an-ssg-migration","Keeping Redirects Working After an SSG Migration",{"path":1325,"title":1326},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fmigrating-a-docs-site-from-jekyll-to-hugo","Migrating a Docs Site From Jekyll to Hugo",{"path":1328,"title":1329},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fmigrating-from-gatsby-to-astro","Migrating from Gatsby to Astro",{"path":1331,"title":1332},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fmigrating-from-hugo-to-astro-without-breaking-urls","Migrating From Hugo to Astro Without Breaking URLs",{"path":1334,"title":1335},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fmigrating-wordpress-to-a-static-site-generator","Migrating WordPress to a Static Site Generator",{"path":1337,"title":1338},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fporting-shortcodes-and-includes-between-generators","Porting Shortcodes and Includes Between Generators",{"path":1340,"title":1341},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fhandling-dynamic-routes-in-nextjs-static-export","Handling Dynamic Routes in Next.js Static Export",{"path":1343,"title":1344},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites","Next.js Static Export for Content Sites",{"path":1346,"title":1347},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fmigrating-from-gatsby-to-nextjs-static-export","Migrating from Gatsby to Next.js Static Export",{"path":1349,"title":1350},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fnextjs-app-router-static-export-limitations","Next.js App Router Static Export Limitations",{"path":1352,"title":1353},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fnextjs-static-export-vs-astro-for-marketing-sites","Next.js Static Export vs Astro for Marketing",{"path":1355,"title":1356},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Foptimizing-images-in-nextjs-static-export","Optimizing Images in Next.js Static Export",{"path":1358,"title":1359},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fadding-pagefind-to-an-astro-site","Adding Pagefind to an Astro Site",{"path":1361,"title":1362},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fbuilding-a-lunr-index-at-build-time-in-eleventy","Building a Lunr Index at Build Time in Eleventy",{"path":1364,"title":1365},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites","Search for Static Sites",{"path":1367,"title":1368},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Findexing-hugo-sites-with-pagefind","Indexing Hugo Sites with Pagefind",{"path":1370,"title":1371},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fmultilingual-search-on-static-sites","Multilingual Search on Static Sites",{"path":1373,"title":1374},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fpagefind-vs-algolia-docsearch","Pagefind vs Algolia DocSearch",{"path":1376,"title":1377},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fsearch-index-size-budgets-for-large-docs","Search Index Size Budgets for Large Docs",{"path":1379,"title":1380},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fbest-ssg-for-technical-writers-without-coding-experience","Best SSG for Non-Developer Technical Writers",{"path":1382,"title":1383},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fchoosing-an-ssg-for-api-reference-documentation","Choosing an SSG for API Reference Documentation",{"path":1385,"title":1386},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fevaluating-ssg-accessibility-defaults","Evaluating SSG Accessibility Defaults",{"path":1388,"title":1389},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix","SSG Framework Selection Matrix",{"path":1391,"title":1392},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fpicking-an-ssg-for-a-multi-language-documentation-site","Picking an SSG for a Multi-Language Docs Site",{"path":1394,"title":1395},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fssg-selection-checklist-for-engineering-teams","SSG Selection Checklist for Engineering Teams",{"path":1397,"title":1398},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Ftotal-cost-of-ownership-for-static-site-generators","Total Cost of Ownership for Static Site Generators",{"path":1400,"title":1401},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fcache-busting-with-content-hashed-filenames","Cache Busting with Content-Hashed Filenames",{"path":1403,"title":1404},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs","CDN Caching Rules for SSGs",{"path":1406,"title":1407},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fpurging-the-cdn-cache-after-a-static-deploy","Purging the CDN Cache After a Static Deploy",{"path":1409,"title":1410},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fsetting-cache-control-headers-on-cloudflare-pages","Cache-Control Headers on Cloudflare Pages",{"path":1412,"title":1413},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fsetting-up-proper-cache-headers-on-netlify","Proper Cache Headers on Netlify for SSGs",{"path":1415,"title":1416},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fstale-while-revalidate-for-static-html","Stale-While-Revalidate for Static HTML",{"path":1418,"title":1419},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Feliminating-layout-shift-from-web-fonts","Eliminating Layout Shift From Web Fonts",{"path":1421,"title":1422},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Ffixing-cls-from-cookie-banners","Fixing CLS from Cookie Banners",{"path":1424,"title":1425},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Ffixing-cls-from-late-loading-embeds","Fixing CLS From Late-Loading Embeds",{"path":1427,"title":1428},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Ffixing-cls-from-sticky-headers-and-anchor-links","Fixing CLS from Sticky Headers and Anchor Links",{"path":1430,"title":1431},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites","Cumulative Layout Shift Fixes for Static Sites",{"path":1433,"title":1434},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Fmeasuring-cls-in-the-field-with-web-vitals-js","Measuring CLS in the Field With web-vitals.js",{"path":1436,"title":1437},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Freserving-space-for-images-and-embeds-to-stop-layout-shift","Reserving Space for Images and Embeds",{"path":1439,"title":1440},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Ffont-display-optional-vs-swap","font-display: optional vs swap",{"path":1442,"title":1443},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites","Font Loading Strategies for Static Sites",{"path":1445,"title":1446},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Fmetric-matched-fallback-fonts-with-size-adjust","Metric-Matched Fallback Fonts with size-adjust",{"path":1448,"title":1449},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Fpreloading-fonts-without-double-downloads","Preloading Fonts Without Double Downloads",{"path":1451,"title":1452},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Fself-hosting-google-fonts-to-eliminate-layout-shift","Self-Host Google Fonts to Eliminate Layout Shift",{"path":1454,"title":1455},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Fsubsetting-variable-fonts-for-faster-first-render","Subsetting Variable Fonts for Faster First Render",{"path":1457,"title":1458},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Fbuilding-an-image-cdn-pipeline-for-static-sites","Building an Image CDN Pipeline for Static Sites",{"path":1460,"title":1461},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Fgenerating-open-graph-images-at-build-time","Generating Open Graph Images at Build Time",{"path":1463,"title":1464},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro","Image Optimization Pipelines in Astro",{"path":1466,"title":1467},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Flazy-loading-images-without-hurting-lcp","Lazy-Loading Images Without Hurting LCP",{"path":1469,"title":1470},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Foptimizing-webp-images-in-hugo-without-plugins","Optimizing WebP Images in Hugo Without Plugins",{"path":1472,"title":1473},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Fresponsive-images-with-srcset-in-eleventy","Responsive Images with srcset in Eleventy",{"path":1475,"title":1476},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Fserving-avif-with-fallbacks-on-static-sites","Serving AVIF With Fallbacks on Static Sites",{"path":1478,"title":1479},"\u002Fperformance-optimization-core-web-vitals-for-ssgs","Core Web Vitals Optimization for SSGs",{"path":1481,"title":1482},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Fastro-islands-vs-full-hydration-performance","Astro Islands vs Full Hydration Performance",{"path":1484,"title":1485},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Fdeferring-hydration-with-client-visible-in-astro","Deferring Hydration with client:visible in Astro",{"path":1487,"title":1488},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Fhow-to-reduce-bundle-size-in-eleventy-builds","How to Reduce Bundle Size in Eleventy Builds",{"path":1490,"title":1491},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering","JavaScript Hydration & Partial Rendering",{"path":1493,"title":1494},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Fmeasuring-inp-on-static-sites-with-real-user-monitoring","Measuring INP on Static Sites with RUM",{"path":1496,"title":1497},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Freplacing-react-islands-with-web-components","Replacing React Islands with Web Components",{"path":1499,"title":1500},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Feliminating-render-blocking-css-on-static-sites","Eliminating Render-Blocking CSS on Static Sites",{"path":1502,"title":1503},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Ffixing-lcp-on-text-heavy-documentation-pages","Fixing LCP on Text-Heavy Documentation Pages",{"path":1505,"title":1506},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites","Largest Contentful Paint Optimization for Static Sites",{"path":1508,"title":1509},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Fmeasuring-lcp-subparts-with-devtools","Measuring LCP Subparts with DevTools",{"path":1511,"title":1512},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Foptimizing-lcp-on-astro-with-priority-hints","Optimizing LCP on Astro with Priority Hints",{"path":1514,"title":1515},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Freducing-lcp-from-hero-images-on-static-sites","Reducing LCP from Hero Images on Static Sites",{"path":1517,"title":1518},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Fcomparing-lab-and-field-data-with-crux","Comparing Lab and Field Data with CrUX",{"path":1520,"title":1521},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci","Performance Budgets and Lighthouse CI",{"path":1523,"title":1524},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Freducing-lighthouse-score-variance-in-ci","Reducing Lighthouse Score Variance in CI",{"path":1526,"title":1527},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Frunning-webpagetest-scripts-against-preview-deploys","Running WebPageTest Scripts Against Preview Deploys",{"path":1529,"title":1530},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Fsetting-up-lighthouse-ci-for-a-static-site","Setting Up Lighthouse CI for a Static Site",{"path":1532,"title":1533},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Ftracking-bundle-size-per-pull-request","Tracking Bundle Size per Pull Request",{"path":1535,"title":1536},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Fwriting-a-performance-budget-that-fails-builds","Writing a Performance Budget That Fails Builds",{"path":1538,"title":1539},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Fauditing-unused-preloads","Auditing Unused Preloads",{"path":1541,"title":1542},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed","Resource Hints and Navigation Speed",{"path":1544,"title":1545},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Finstant-navigation-with-speculation-rules","Instant Navigation with Speculation Rules",{"path":1547,"title":1548},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Fpreconnect-vs-dns-prefetch-on-static-sites","Preconnect vs DNS-Prefetch on Static Sites",{"path":1550,"title":1551},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Fprefetching-links-in-astro","Prefetching Links in Astro",{"path":1553,"title":1554},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Fview-transitions-on-multi-page-static-sites","View Transitions on Multi-Page Static Sites",{"path":1556,"title":1557},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Fauditing-third-party-scripts-with-lighthouse","Auditing Third-Party Scripts With Lighthouse",{"path":1559,"title":1560},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites","Third-Party Script Performance on Static Sites",{"path":1562,"title":1563},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Flazy-loading-youtube-embeds-on-static-sites","Lazy-Loading YouTube Embeds on Static Sites",{"path":1565,"title":1566},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Floading-google-tag-manager-without-hurting-inp","Loading Google Tag Manager Without Hurting INP",{"path":1568,"title":1569},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Frunning-third-party-scripts-in-a-web-worker-with-partytown","Running Third-Party Scripts in a Web Worker with Partytown",{"path":1571,"title":1572},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Fself-hosting-analytics-to-cut-third-party-requests","Self-Hosting Analytics to Cut Third-Party Requests",{"path":1574,"title":1575},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fautomating-eleventy-deployments-with-cloudflare-pages","Automating Eleventy Deployments on Cloudflare Pages",{"path":1577,"title":1578},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fconfiguring-redirects-on-cloudflare-pages","Configuring Redirects on Cloudflare Pages",{"path":1580,"title":1581},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fcustom-domains-and-tls-on-cloudflare-pages","Custom Domains and TLS on Cloudflare Pages",{"path":1583,"title":1584},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fdeploying-hugo-to-cloudflare-pages-and-workers","Deploying Hugo to Cloudflare Pages and Workers",{"path":1586,"title":1587},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup","Cloudflare Pages Edge Caching Setup",{"path":1589,"title":1590},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fmigrating-from-cloudflare-pages-to-workers-static-assets","Migrating from Cloudflare Pages to Workers Static Assets",{"path":1592,"title":1173},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fchecking-links-in-pull-requests",{"path":1594,"title":44},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fdocs-as-code-review-workflow-for-writers",{"path":1232,"title":5},{"path":1597,"title":24},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams",{"path":1599,"title":1600},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fscheduling-content-publication-with-cron-triggered-builds","Scheduling Content Publication With Cron-Triggered Builds",{"path":1602,"title":1603},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fwiring-a-headless-cms-to-a-static-build","Wiring a Headless CMS to a Static Build",{"path":1605,"title":1606},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fbuilding-astro-sites-with-github-actions","Building Astro Sites with GitHub Actions",{"path":1608,"title":1609},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fcaching-node-modules-in-github-actions-for-faster-ssg-builds","Caching node_modules in GitHub Actions",{"path":1611,"title":1612},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fdeploying-to-github-pages-with-actions","Deploying to GitHub Pages with Actions",{"path":1614,"title":1615},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fdeploying-to-multiple-environments-from-one-workflow","Deploying to Multiple Environments From One Workflow",{"path":1617,"title":1618},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fhow-to-set-up-github-actions-for-hugo-deployments","GitHub Actions for Hugo Deployments",{"path":1620,"title":1621},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds","GitHub Actions for Automated SSG Builds",{"path":1623,"title":1624},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fmatrix-builds-for-multi-site-monorepos","Matrix Builds for Multi-Site Monorepos",{"path":1626,"title":1627},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fcaching-hugo-builds-in-github-actions","Caching Hugo Builds in GitHub Actions",{"path":1629,"title":1630},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fenabling-incremental-builds-in-eleventy","Enabling Incremental Builds in Eleventy",{"path":1632,"title":1633},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fincremental-builds-in-astro-with-the-content-layer","Incremental Builds in Astro with the Content Layer",{"path":1635,"title":1636},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs","Incremental Builds and Build Caching for SSGs",{"path":1638,"title":1639},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fmeasuring-build-time-regressions-in-ci","Measuring Build-Time Regressions in CI",{"path":1641,"title":1642},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fremote-caching-with-turborepo-for-ssg-monorepos","Remote Caching with Turborepo for SSG Monorepos",{"path":1644,"title":1645},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fsharing-build-cache-across-ci-runners","Sharing Build Cache Across CI Runners",{"path":1647,"title":1648},"\u002Fproduction-ready-deployment-cicd-workflows","Production-Ready Deployment & CI\u002FCD for SSGs",{"path":1650,"title":1651},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Falerting-on-cache-hit-ratio-drops","Alerting on Cache Hit Ratio Drops",{"path":1653,"title":1654},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Fbuilding-a-core-web-vitals-dashboard-from-rum-data","Building a Core Web Vitals Dashboard from RUM Data",{"path":1656,"title":1657},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Fcrawling-for-broken-links-on-a-schedule","Crawling for Broken Links on a Schedule",{"path":1659,"title":1660},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production","Monitoring Static Sites in Production",{"path":1662,"title":1663},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Flogging-404s-at-the-edge","Logging 404s at the Edge",{"path":1665,"title":1666},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Fuptime-and-synthetic-checks-for-static-sites","Uptime and Synthetic Checks for Static Sites",{"path":1668,"title":1669},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fconfiguring-vercel-for-hugo-and-eleventy","Configuring Vercel for Hugo and Eleventy",{"path":1671,"title":1672},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies","Netlify vs Vercel Deployment Strategies",{"path":1674,"title":1675},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fnetlify-build-hooks-for-content-updates","Netlify Build Hooks for Content Updates",{"path":1677,"title":1678},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fnetlify-redirects-and-rewrites-for-static-sites","Netlify Redirects and Rewrites for Static Sites",{"path":1680,"title":1681},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fsetting-up-deploy-previews-on-netlify-for-every-pull-request","Netlify Deploy Previews for Every Pull Request",{"path":1683,"title":1684},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fvercel-isr-vs-static-generation-for-ssgs","Vercel ISR vs Static Generation for SSGs",{"path":1686,"title":1687},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fautomating-preview-deploy-pipelines-with-github-actions","Automating Preview Deploy Pipelines with GitHub Actions",{"path":1689,"title":1690},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fcleaning-up-stale-preview-deployments","Cleaning Up Stale Preview Deployments",{"path":1692,"title":1693},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests","Preview Environments for Pull Requests",{"path":1695,"title":1696},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fpassword-protecting-preview-deployments","Password-Protecting Preview Deployments",{"path":1698,"title":1699},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fpreviewing-headless-cms-drafts","Previewing Headless CMS Drafts",{"path":1701,"title":1702},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fvisual-regression-testing-on-preview-deploys","Visual Regression Testing on Preview Deploys",{"path":1704,"title":1705},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Fatomic-deploys-vs-incremental-uploads","Atomic Deploys vs Incremental Uploads",{"path":1707,"title":1708},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Fcanary-releases-for-static-sites","Canary Releases for Static Sites",{"path":1710,"title":1711},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Ffeature-flags-on-static-sites","Feature Flags on Static Sites",{"path":1713,"title":1714},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites","Rollbacks and Deploy Safety for Static Sites",{"path":1716,"title":1717},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Frolling-back-a-bad-static-deploy-in-under-a-minute","Rolling Back a Bad Static Deploy in Under a Minute",{"path":1719,"title":1180},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Frunning-smoke-tests-against-a-preview-url",{"path":1721,"title":1722},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fauditing-npm-dependencies-in-ssg-pipelines","Auditing npm Dependencies in SSG Pipelines",{"path":1724,"title":1725},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fenabling-hsts-and-preload-safely","Enabling HSTS and Preload Safely",{"path":1727,"title":1728},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fhash-based-csp-for-inline-scripts-in-astro","Hash-Based CSP for Inline Scripts in Astro",{"path":1730,"title":1731},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites","Security Headers and Hardening for Static Sites",{"path":1733,"title":1734},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fsecuring-deploy-credentials-with-github-oidc","Securing Deploy Credentials with GitHub OIDC",{"path":1736,"title":1737},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fsubresource-integrity-for-third-party-assets","Subresource Integrity for Third-Party Assets",{"path":1739,"title":1740},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fwriting-a-content-security-policy-for-a-static-site","Writing a Content Security Policy for a Static Site",{"path":1742,"title":1743},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fclean-urls-and-trailing-slashes-on-s3","Clean URLs and Trailing Slashes on S3",{"path":1745,"title":1746},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fcloudfront-functions-for-redirects","CloudFront Functions for Redirects",{"path":1748,"title":1749},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fdeploying-a-static-site-to-s3-and-cloudfront","Deploying a Static Site to S3 and CloudFront",{"path":1751,"title":1752},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites","Self-Hosting Static Sites on S3, Nginx and Caddy",{"path":1754,"title":1755},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fserving-a-static-site-with-caddy","Serving a Static Site with Caddy",{"path":1757,"title":1758},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fserving-a-static-site-with-nginx","Serving a Static Site with Nginx",{"path":1760,"title":1761},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fzero-downtime-deploys-with-symlink-swaps","Zero-Downtime Deploys with Symlink Swaps",{"path":1763,"title":1764},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Fadding-a-contact-form-with-cloudflare-workers","Adding a Contact Form with Cloudflare Workers",{"path":1766,"title":1767},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Fhandling-form-submissions-on-a-static-site","Handling Form Submissions on a Static Site",{"path":1769,"title":1770},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites","Serverless Functions for Static Sites",{"path":1772,"title":1773},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Fnetlify-functions-vs-cloudflare-workers","Netlify Functions vs Cloudflare Workers",{"path":1775,"title":1776},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Fprotecting-a-static-site-behind-authentication","Protecting a Static Site Behind Authentication",{"path":1778,"title":1779},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Fproxying-third-party-apis-from-an-edge-function","Proxying Third-Party APIs from an Edge Function",1789722847301]