1621950 - Linking from .md files to .rst files is a suboptimal experience

Status: RESOLVED FIXED

(Developer Infrastructure :: Source Documentation, defect)

Description

[Chris H-C :chutten]

To reference from md files other documentation written in markdown, you can use the form /path/to/doc_file.md and someone in the recommonmark/sphinx stack will rewrite that for you to an appropriate absolute url ending in .html.

To reference from md files other documentation written in rst, things are not so rosy. I've tried "Pagenmame" "../sphinx/path/to/Pagename" "doc_file_name.rst".... the only one that seems to work is ../resulting/relative/http/path/to/doc_file_name.html.

And that one unfortunately springs a warning WARNING: None:any reference target not found:

Comment 1

[Anurag Aggarwal]

On changing

[Quick Start Guide](https://firefox-source-docs.mozilla.org/mobile/android/geckoview/consumer/docs/geckoview-quick-start.html)

to

[Quick Start Guide](./consumer/docs/geckoview-quick-start.html)

here
results link not to be created.

While the same works if used in a non bullet point format.

Comment 2

[Chris H-C :chutten]

That might be a separate issue with how recommonmark uses bullet-point lists to generate tables of contents: https://recommonmark.readthedocs.io/en/latest/auto_structify.html#auto-toc-tree

Comment 3

[Firefox Bug Husbandry Bot]

Because this bug's Severity has not been changed from the default since it was filed, and it's Priority is -- (Backlog,) indicating it has has not been previously triaged, the bug's Severity is being updated to -- (default, untriaged.)

Comment 4

[Firefox Bug Husbandry Bot]

Because this bug's Severity has not been changed from the default since it was filed, and it's Priority is -- (Backlog,) indicating it has has not been previously triaged, the bug's Severity is being updated to -- (default, untriaged.)

Comment 5

[Firefox Bug Husbandry Bot]

Because this bug's Severity has not been changed from the default since it was filed, and it's Priority is -- (Backlog,) indicating it has has not been previously triaged, the bug's Severity is being updated to -- (default, untriaged.)

Comment 6

[Firefox Bug Husbandry Bot]

The severity of these bugs was changed, mistakenly, from normal to S3.

Because these bugs have a priority of --, indicating that they have not been previously triaged, these bugs should be changed to Severity of --.

Comment 7

[ogiorgis]

Attachment: Bug 1621950 - fix some myst ref warnings r=#firefox-source-docs-reviewers

Depends on D173704

Comment 8

[Pulsebot]

Pushed by [e-mail]:
https://hg.mozilla.org/integration/autoland/rev/8c35fddc4405
fix some myst ref warnings r=firefox-source-docs-reviewers,devtools-reviewers,sylvestre

Comment 9

[Sandor Molnar[:smolnar]]

https://hg.mozilla.org/mozilla-central/rev/8c35fddc4405