PR#172: Fix xref for first steps - fedora-commops

fedora-commops

#172 Fix xref for first steps

Merged 5 years ago by jflory7. Opened 5 years ago by bex.

Unknown source first_steps_fix into master

Fix xref for first steps

Brian (bex) Exelbierd • 5 years ago

34bb178

docs/modules/ROOT/pages/contribute/join.adoc

file modified

+1 -1

		`@@ -66,7 +66,7 @@`
		`[[first-steps]]`
		`== Make your first steps`

		`- See xref:first-steps.adoc[Make your first steps in Fedora] for more info.`
		`+ See xref:contribute/first-steps.adoc[Make your first steps in Fedora] for more info.`


		`[[start-task]]`

no initial comment

bex commented 5 years ago

@asamalik can you comment on this xref structure? Why do we need the full path here?

bex commented 5 years ago

@asamalik can you comment on this xref structure? Why do we need the full path here?

OK, I did some looking into this and it appears to be because there is a section of this document with the same name as the other page so we have to use the path to differentiate them.

asamalik commented 5 years ago

@bex that reflects the directory structure under pages. See the Page ID — the last green part labeled "path to source page in module" is exactly that. We can't go shorter than this.