[{"data":1,"prerenderedAt":351},["ShallowReactive",2],{"navigation_docs":3,"rule-content-\u002Ftypescript\u002Frules\u002Fstrict\u002Fno-comments":48},[4,8,12,16,20,24,28,32,36,40,44],{"title":5,"path":6,"stem":7},"CLI","\u002Fcli","1.cli",{"title":9,"path":10,"stem":11},"Nuxt","\u002Fnuxt","2.nuxt",{"title":13,"path":14,"stem":15},"Vue","\u002Fvue","3.vue",{"title":17,"path":18,"stem":19},"Vite","\u002Fvite","4.vite",{"title":21,"path":22,"stem":23},"Nitro","\u002Fnitro","5.nitro",{"title":25,"path":26,"stem":27},"TypeScript","\u002Ftypescript","6.typescript",{"title":29,"path":30,"stem":31},"shadcn","\u002Fshadcn","7.shadcn",{"title":33,"path":34,"stem":35},"Package","\u002Fpackage","8.package",{"title":37,"path":38,"stem":39},"Extending Doctor","\u002Fextending","9.extending",{"title":41,"path":42,"stem":43},"MCP","\u002Fmcp","9.mcp",{"title":45,"path":46,"stem":47},"Pinia","\u002Fpinia","9.pinia",{"id":49,"title":50,"body":51,"category":57,"description":339,"diagnosticCodes":340,"docsUrl":59,"extension":341,"fix":60,"framework":342,"meta":343,"navigation":344,"pack":61,"path":346,"recommendedReplacement":168,"ruleId":62,"seo":347,"severity":63,"source":64,"sourceUrl":65,"stem":348,"why":349,"__hash__":350},"rules\u002Ftypescript\u002Frules\u002Fstrict\u002Fno-comments.md","Report comments without a recognized exemption",{"type":52,"value":53,"toc":329},"minimark",[54,66,96,101,132,136,162,166,169,173,184,188,193,196,267,270,325],[55,56],"rule-metadata",{"category":57,"diagnosticCodes":58,"docsUrl":59,"fix":60,"pack":61,"ruleId":62,"severity":63,"source":64,"sourceUrl":65},"strict","TS0017","https:\u002F\u002Fvite-doctor.onmax.me\u002Ftypescript#delete-comments-no-tool-reads","unsafe","vite-doctor\u002Ftypescript","typescript\u002Fstrict\u002Fno-comments","warn","src\u002Frule-packs\u002Ftypescript\u002Frules\u002Fno-comments.ts","https:\u002F\u002Fgithub.com\u002Fonmax\u002Fvite-doctor\u002Fblob\u002Fmain\u002Fsrc\u002Frule-packs\u002Ftypescript\u002Frules\u002Fno-comments.ts",[67,68,69,70,73,74,77,78,81,82,87,88,91,92,95],"p",{},"This opt-in rule is in no preset, ",[71,72,57],"code",{}," included. Turn it on with ",[71,75,76],{},"\"rules\": { \"typescript\u002Fstrict\u002Fno-comments\": \"warn\" }"," in ",[71,79,80],{},"doctor.config.json",". See the ",[83,84,86],"a",{"href":85},"\u002Ftypescript#delete-comments-no-tool-reads","TypeScript guide"," for what it keeps, its options, how to adopt it with ",[71,89,90],{},"--since",", and how ",[71,93,94],{},"--unsafe-fix"," deletes comments once you have classified them.",[97,98,100],"h2",{"id":99},"run-this-rule","Run this rule",[102,103,108],"pre",{"className":104,"code":105,"language":106,"meta":107,"style":107},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm vite-doctor . --rules typescript\u002Fstrict\u002Fno-comments\n","bash","",[71,109,110],{"__ignoreMap":107},[111,112,115,119,123,126,129],"span",{"class":113,"line":114},"line",1,[111,116,118],{"class":117},"sBMFI","pnpm",[111,120,122],{"class":121},"sfazB"," vite-doctor",[111,124,125],{"class":121}," .",[111,127,128],{"class":121}," --rules",[111,130,131],{"class":121}," typescript\u002Fstrict\u002Fno-comments\n",[97,133,135],{"id":134},"why-it-matters","Why it matters",[67,137,138,139,142,143,146,147,150,151,142,154,157,158,161],{},"A comment that repeats the code goes stale when the code changes, and agents read stale comments as facts. The Rule recognizes common compiler, linter, formatter, and coverage directives, bundler annotations such as ",[71,140,141],{},"#__PURE__"," and ",[71,144,145],{},"@vite-ignore",", triple-slash references, ",[71,148,149],{},"\u002F*!",", ",[71,152,153],{},"@license",[71,155,156],{},"@preserve"," comments, source map comments, SAFETY notes, semantic JSDoc, and, by default, JSDoc on exported declarations and their members. Use ",[71,159,160],{},"allow"," for comments that other project tools consume.",[97,163,165],{"id":164},"recommended-fix","Recommended fix",[67,167,168],{},"Check whether a project tool reads the comment before removing it; if it does, add a pattern to allow it. Move non-obvious decisions to the project's decision log and file issues for workarounds before removing their comments. When removing a script or JSX comment, preserve its line breaks and use a space if the comment separates tokens.",[97,170,172],{"id":171},"useful-links","Useful links",[174,175,176],"ul",{},[177,178,179],"li",{},[83,180,183],{"href":59,"rel":181},[182],"nofollow","Rule reference",[97,185,187],{"id":186},"example","Example",[189,190,192],"h3",{"id":191},"name-the-code-instead-of-describing-it","Name the code instead of describing it",[67,194,195],{},"Before",[102,197,201],{"className":198,"code":199,"language":200,"meta":107,"style":107},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u002F\u002F Retry three times before giving up.\nfor (let attempt = 0; attempt \u003C 3; attempt++) await send()\n","ts",[71,202,203,209],{"__ignoreMap":107},[111,204,205],{"class":113,"line":114},[111,206,208],{"class":207},"sHwdD","\u002F\u002F Retry three times before giving up.\n",[111,210,212,216,220,224,227,231,235,238,240,243,246,248,251,254,257,260,264],{"class":113,"line":211},2,[111,213,215],{"class":214},"s7zQu","for",[111,217,219],{"class":218},"sTEyZ"," (",[111,221,223],{"class":222},"spNyl","let",[111,225,226],{"class":218}," attempt ",[111,228,230],{"class":229},"sMK4o","=",[111,232,234],{"class":233},"sbssI"," 0",[111,236,237],{"class":229},";",[111,239,226],{"class":218},[111,241,242],{"class":229},"\u003C",[111,244,245],{"class":233}," 3",[111,247,237],{"class":229},[111,249,250],{"class":218}," attempt",[111,252,253],{"class":229},"++",[111,255,256],{"class":218},") ",[111,258,259],{"class":214},"await",[111,261,263],{"class":262},"s2Zo4"," send",[111,265,266],{"class":218},"()\n",[67,268,269],{},"After",[102,271,273],{"className":198,"code":272,"language":200,"meta":107,"style":107},"const maxSendAttempts = 3\nfor (let attempt = 0; attempt \u003C maxSendAttempts; attempt++) await send()\n",[71,274,275,288],{"__ignoreMap":107},[111,276,277,280,283,285],{"class":113,"line":114},[111,278,279],{"class":222},"const",[111,281,282],{"class":218}," maxSendAttempts ",[111,284,230],{"class":229},[111,286,287],{"class":233}," 3\n",[111,289,290,292,294,296,298,300,302,304,306,308,311,313,315,317,319,321,323],{"class":113,"line":211},[111,291,215],{"class":214},[111,293,219],{"class":218},[111,295,223],{"class":222},[111,297,226],{"class":218},[111,299,230],{"class":229},[111,301,234],{"class":233},[111,303,237],{"class":229},[111,305,226],{"class":218},[111,307,242],{"class":229},[111,309,310],{"class":218}," maxSendAttempts",[111,312,237],{"class":229},[111,314,250],{"class":218},[111,316,253],{"class":229},[111,318,256],{"class":218},[111,320,259],{"class":214},[111,322,263],{"class":262},[111,324,266],{"class":218},[326,327,328],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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);}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}",{"title":107,"searchDepth":211,"depth":211,"links":330},[331,332,333,334,335],{"id":99,"depth":211,"text":100},{"id":134,"depth":211,"text":135},{"id":164,"depth":211,"text":165},{"id":171,"depth":211,"text":172},{"id":186,"depth":211,"text":187,"children":336},[337],{"id":191,"depth":338,"text":192},3,"Report script, JSX, and Vue template comments that do not match a known directive or configured exemption. Opt-in: no Preset turns it on.",[58],"md","typescript",{},{"title":345},"Comments","\u002Ftypescript\u002Frules\u002Fstrict\u002Fno-comments",{"title":50,"description":339},"typescript\u002Frules\u002Fstrict\u002Fno-comments","A comment that repeats the code goes stale when the code changes, and agents read stale comments as facts. The Rule recognizes common compiler, linter, formatter, and coverage directives, bundler annotations such as `#__PURE__` and `@vite-ignore`, triple-slash references, `\u002F*!`, `@license` and `@preserve` comments, source map comments, SAFETY notes, semantic JSDoc, and, by default, JSDoc on exported declarations and their members. Use `allow` for comments that other project tools consume.","QJo7VjTG1wV1aRePx7hzLSvH2YcNiF0Z8xF52SlP_lI",1795268793050]