[Bug]: yarn explain returns internal error, 404 because of Gatsby -> Docusaurus move about berry HOT 4 OPEN

Oh good point, I didn't think about this command when we migrated from Gatsby to Docusaurus 🤔

Unfortunately we also recently changed from md to mdx, so there isn't a tagged url yet that works (it will only stop 404'ing after the next release). It should be:

https://repo.yarnpkg.com/${version}/packages/docusaurus/docs/advanced/01-general-reference/error-codes.mdx

from berry.

It appears (see explain.ts line 19) to be trying to fetch the URL https://repo.yarnpkg.com/${version}/packages/gatsby/content/advanced/error-codes.md. Indeed, replacing 4.1.1 for version gives a 404 (here). Likewise, the help message when an error does not exists (explain.ts line 91) points to this file, but in the Github repo.

from berry.

I suppose the new location for this file would be this: https://github.com/yarnpkg/berry/blob/52252b0caa3ac6d753348b271f91090f2724d089/packages/docusaurus/docs/advanced/01-general-reference/error-codes.mdx?plain=1 – but in a different format?

from berry.

Ok! Would there also be other code changes required to support the format changes, or will updating the URL in the command be enough? As far as I can tell, not much MDX is used in this particular file?

from berry.