Fixes over 500 broken links in docs

[discdiver]

Spot checked locally. Much improved.

Update down to 159 broken links, and redirect rules, should we add them, and changing how some API docs are built will likely take care of most of the remaining links..

Example

Checklist

• This pull request references any related issue by including "closes <link to issue>"
  • If no issue exists and your change is not a small fix, please create an issue first.
• If this pull request adds new functionality, it includes unit tests that cover the changes
• This pull request includes a label categorizing the change e.g. maintenance, fix, feature, enhancement, docs.

For documentation changes:

• This pull request includes redirect settings in mint.json for files that are removed or renamed.

For new functions or classes in the Python SDK:

• This pull request includes helpful docstrings.
• If a new Python file was added, this pull request contains a stub page in the Python SDK docs and an entry in docs/mint.json navigation.

[serinamarie]

Sorry if I'm not understanding but isn't there a way to keep the version out of the link rather than hardcode it? Like we had in 2.x?

[discdiver]

Sorry if I'm not understanding but isn't there a way to keep the version out of the link rather than hardcode it? Like we had in 2.x?

That would be nice. I've read the docs, searched the docs with the LLM, and asked about relative links (relative to the file path of the object in question) twice. Doesn't appear so. I requested they add the feature, but get that it might be tricky.

Preveioulsy, 2e built full versions of our docs with 2.0 for each release. Mike took care of the version management for the most part. Mintlify doesn't do that.

Ideally, if there isn't a relative link solution in the future, we will automate regex parsing to create new URLs. We don't plan to build new versions on every patch, fwiw.

[serinamarie]

Gotcha, will the docs still be versioned then? As in when 3.1 is released you can still toggle to 3.0?

[discdiver]

Gotcha, will the docs still be versioned then? As in when 3.1 is released you can still toggle to 3.0?

That's the plan!

[billpalombi]

Thank you!