Links in overview of admin quick start guide broken

AI-generated summary

The discussion addresses broken links in the admin quick start guide, specifically due to anchor ID changes in the documentation. Moin reports that links no longer work because the anchor now includes a post ID (e.g., #p-7-magic_wand-complete-the-setup-wizard-3), while the guide references #magic_wand-complete-the-setup-wizard-3. hugh submits a PR to fix the issue, but Moin notes the fix doesn’t resolve the problem since the post ID isn’t added. NateDhaliwal also contributes a PR to fix details syntax, though Moin clarifies it’s unrelated. The PR by hugh was approved but never merged, and Moin concludes the issue can be closed as the section is no longer part of the guide.

The links in this checklist of the admin getting started guide no longer work for me

In FIX: Add post id to the anchor to prevent two identical anchors by Lhcfl · Pull Request #28070 · discourse/discourse · GitHub the post-id was added to the anchor.

So while the link links to #magic_wand-complete-the-setup-wizard-3 the anchor of that heading is actually #p-7-magic_wand-complete-the-setup-wizard-3.

Is the id of that post always the same, so that it can simply be added to the link?

2 Likes

Thanks @Moin! I’ve updated this in this PR: Fixing admin quick start links and formatting by hlashbrooke · Pull Request #29711 · discourse/discourse · GitHub - just needs to be approved and merged, which should happen shortly.

1 Like

Just to add on, I noticed that [details] wasn’t working, so I opened a Pull Request to fix that using <details> instead.

1 Like

I am not sure that will fix it. You have removed the number at the end, but you did not add the post ID. I tried editing the topic in my #staff category, which is created from the guide, like in your PR, and then the link still doesn’t take me to that section.

Therefore, I have no problem with the [details], they work fine in my Discourse topic.

The PR above was approved but never merged.

Anyway, I think this can be closed. That section is no longer part of the guide.

3 Likes