Skip to content

docs: reformat in-page links in tutorials#2534

Open
activus-d wants to merge 1 commit intocanonical:mainfrom
activus-d:redo-tutorials
Open

docs: reformat in-page links in tutorials#2534
activus-d wants to merge 1 commit intocanonical:mainfrom
activus-d:redo-tutorials

Conversation

@activus-d
Copy link
Contributor

This PR fixes the in-page links in the Tutorial section of the documentation by moving single-link block references into the main text.

This is the first in a series of PRs addressing Open Documentation Academy issue #302.

It's intended to confirm that the chosen approach aligns with the preferred solution. Feedback from this PR will be taken into account in subsequent PRs related to the same issue.

Copy link
Contributor

@medubelko medubelko left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@activus-d This is great work! :D

I've left some suggestions for improvement. The first one is the most important. The rest are more subtle and in line with how we write links in other craft apps.

Don't worry about the CI failures for now. Some of those have nothing to do with your PR.

implement feedback

add multipass to Intersphinx map
Copy link
Contributor

@medubelko medubelko left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! These are effective patterns, and are a much-needed improvement. I think you're primed to take these to the rest of the docs.

The build is going to flag some issues unrelated to the docs, which Alex and I can tackle.

@lengau Ready for your review.

@medubelko medubelko changed the title Redo in-page links for docs' tutorials docs: reformat in-page links in tutorials Jan 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants