Note in fetch-doc description that shopify.dev serves Markdown for every page

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: nelsonwittwer

packages/cli/README.md

@@ -1215,7 +1215,7 @@ DESCRIPTION
 
 ## `shopify fetch-doc [URL]`
 
-Download a complete document from shopify.dev, returned as Markdown by default. Use this to pull an entire document verbatim — for example, a set of instructions an agent follows like a centrally-served skill. For finding the relevant pieces of content across shopify.dev instead, use `search`.
+Download a complete document from shopify.dev. Every page on shopify.dev has a Markdown version, and that is what this tool returns by default. Use this to pull an entire document verbatim — for example, a set of instructions an agent follows like a centrally-served skill. For finding the relevant pieces of content across shopify.dev instead, use `search`.
 
 ```
 USAGE
@@ -1229,9 +1229,10 @@ FLAGS
                           text/markdown).
 
 DESCRIPTION
-  Download a complete document from shopify.dev, returned as Markdown by default. Use this to pull an entire document
-  verbatim — for example, a set of instructions an agent follows like a centrally-served skill. For finding the relevant
-  pieces of content across shopify.dev instead, use `search`.
+  Download a complete document from shopify.dev. Every page on shopify.dev has a Markdown version, and that is what this
+  tool returns by default. Use this to pull an entire document verbatim — for example, a set of instructions an agent
+  follows like a centrally-served skill. For finding the relevant pieces of content across shopify.dev instead, use
+  `search`.
 
 EXAMPLES
   # fetch the Markdown version of a Shopify.dev page

packages/cli/oclif.manifest.json

@@ -3544,7 +3544,7 @@
           "required": true
         }
       },
-      "description": "Download a complete document from shopify.dev, returned as Markdown by default. Use this to pull an entire document verbatim — for example, a set of instructions an agent follows like a centrally-served skill. For finding the relevant pieces of content across shopify.dev instead, use `search`.",
+      "description": "Download a complete document from shopify.dev. Every page on shopify.dev has a Markdown version, and that is what this tool returns by default. Use this to pull an entire document verbatim — for example, a set of instructions an agent follows like a centrally-served skill. For finding the relevant pieces of content across shopify.dev instead, use `search`.",
       "enableJsonFlag": false,
       "examples": [
         "# fetch the Markdown version of a Shopify.dev page\n    shopify fetch-doc https://shopify.dev/docs/api/shopify-cli\n\n    # fetch the HTML version of a Shopify.dev page\n    shopify fetch-doc https://shopify.dev/docs/api/shopify-cli --content-type text/html\n    "

packages/cli/src/cli/commands/fetch-doc.ts

@@ -4,7 +4,7 @@ import {Args, Flags} from '@oclif/core'
 
 export default class FetchDoc extends Command {
   static description =
-    'Download a complete document from shopify.dev, returned as Markdown by default. Use this to pull an entire document verbatim — for example, a set of instructions an agent follows like a centrally-served skill. For finding the relevant pieces of content across shopify.dev instead, use `search`.'
+    'Download a complete document from shopify.dev. Every page on shopify.dev has a Markdown version, and that is what this tool returns by default. Use this to pull an entire document verbatim — for example, a set of instructions an agent follows like a centrally-served skill. For finding the relevant pieces of content across shopify.dev instead, use `search`.'
 
   static usage = `fetch-doc [URL]`