mathjax / MathJax-docs

MathJax documentation. Beautiful math in all browsers. Beautifully documented.
Apache License 2.0
548 stars 231 forks source link

Getting started documentation of of date #295

Open h3har opened 3 years ago

h3har commented 3 years ago

The documentation found here appears to be out of date - the section describing "Downloading and Installing MathJax" says that "...refer to the main MathJax file via the URL /MathJax/MathJax.js", however there is no MathJax.js file in the repository. It also references a MathJax/test directory - however there appears to be no such directory.

I'm referring to the repository here which is linked by the documentation.

dpvc commented 2 years ago

The documentation you are referring to is for v2 of MathJax. The current version is v3, which was a substantial rewrite, and the files are not the same in version 3. The MathJax repository now holds the v3 code. You can still access the older v2 code, which is in the legacy-v2 branch of that repository.

The version of the documentation you are viewing can be changed via the green version menu at the lower left of the documentation. Switch to the v3 documentation unless you are using MathJax v2 (you may want to go to the top-level page first, as the document structure is not the same in v3, and it may try to take you to a non-existent page).

h3har commented 2 years ago

Thank you :-)

Nonetheless, the links in the docs are incorrect and should point to this legacy-v2 branch!

I'll also note that, while v3.2 is the newest version, lots of Google search results for "MathJax docs" and related queries (e.g., to the "Getting Started" page) still link to the v2.7 documentation - which is why I ended up in that documentation.