Fix sidebar links for pub packages

[srawlins]

I believe this fixes the sidebar issues in dart-lang/pub-dev#7058. CC @isoos

I've confirmed that (locally), this keeps working links in Flutter, a pub package, and the Dart SDK.

---

• I’ve reviewed the contributor guide and applied the relevant portions to this PR.

Contribution guidelines:

• See our contributor guide for general expectations for PRs.
• Larger or significant changes should be discussed in an issue before creating a PR.
• Contributions to our repos should follow the Dart style guide and use dart format.
• Most changes should add an entry to the changelog and may need to rev the pubspec package version.
• Changes to packages require corresponding tests.

Note that many Dart repos have a weekly cadence for reviewing PRs - please allow for some latency before initial review feedback.

[isoos]

Yes, this may fix it. I will also test it on Monday...

[isoos]

I have tested this on the fake pub-dev server, and can confirm that it fixes the issue. 🚀

[isoos]

@srawlins: any plans on when this will be released?

[srawlins]

@isoos are you working off of pub releases? We've been sitting on 7.0.0-wip for a while but we can pull the trigger. I need to get this latest code into Google internal to vet it, then I can cut a release.

[parlough]

I guess I didn't fully follow the issue. Does this affect docs generated with dart doc or is it more specific to the replacements that pub makes? If it affects dart doc, might be worth releasing 7.0.0 and cherry-picking to 3.2 beta.

[srawlins]

Yes, it should affect dart doc. I'll be curious to know if it is an existing issue in Dart 3.1.0.

[isoos]

are you working off of pub releases?

Yes, we import published versions. It can be a prerelease if you wanted to.

[parlough]

I'll be curious to know if it is an existing issue in Dart 3.1.0.

It should be. The dartdoc version in 3.1 (e04a6b3) is after the sidebars were split out.

Edit: I tested locally with 3.1.3 and the issues are present.

---

I opened #3514 since I think it is worth the cherry-pick as some pages are quite broken. Not necessarily for 3.1 at the point, but definitely for 3.2 :)