Provide online documentation for legacy releases?

[ragaskar]

Hi folks:

I hadn't been aware of the mermaid-js project, but it is super cool. That said, our Github Enterprise instance is running v10.0.2 of mermaid, and I am having a heck of a time getting documentation specific to that version. I spent some time searching for "legacy docs" and was unable to find anything (the actual docs site has a tantalizing version number in the header, but no other versions are available). I assumed that I would need to clone the version itself and build the docs, but this put me in a deep yak-shaving hole. The npx install pnpm invocation fails on my machine due to a missing template for vitepress-plugin, and now I'm removing nodenv and installing volta to exactly match what is described in the 10.0.2 CONTRIBUTING.md, but now I'm really far away from my original goal which is just to see docs relevant to the mermaid version I'll be developing for.

Are prior docs hosted somewhere? If so could those links be made more prominent? Is it easy enough to host prior docs? (I admit I'm unaware how many versions of mermaid are out there, obvs, w/ release numbers like 10.0.2, it could be quite a few). Is this just such an old version of mermaid that I should suck it up and shave the yaks in front of me?

Anyhow, I'm planning on doing some more shaving but figured I could drop this discussion for future folks trying to do the same thing I am, so they might at least know what direction to start in.

[ragaskar]

(fwiw, using volta instead of nodenv does not solve the error I'm encountering, which is:

"error TS7016: Could not find a declaration file for module 'vitepress-plugin-search'", which occurs when "tsc" (type script .. compiler?) tries to "-p" the ./packages/mermaid/tsconfig.json

This might be a trivial error for someone familiar with typescript to resolve, but .. basically a showstopper for me.

[ragaskar]

I've given up. It's deep in some kind of typescript problem that may? be related to the settings, or related to the packages installed, or?

I've tried on a separate machine, and tried at a few different release tags.

I'll just brute force it by seeing what doesn't work in 10.0.2, I guess.

[ragaskar]

As a FWIW for others in this situation, this gist seems to provide some good examples of what features one can expect to use on github (and also which ones may not work, despite the version): https://gist.github.com/ChristopherA/bffddfdf7b1502215e44cec9fb766dfd