Allow putting other content after link in See Also

[a-docc-user]

Feature Name

Allow putting other content after link in See Also.

Description

For example, the following markup

## See Also
- [.ZIP File Format Specification](https://github.com/zlib-ng/minizip-ng/blob/master/doc/zip/appnote.txt) § 4.4.3

currently results in

See Also

• .ZIP File Format Specification

The section number is stripped! (There is also a warning)
An alternative would be to put the section number in the link, but the link does not take you to the section, but to the top of the file!

Expected Behavior

It working correctly:

See Also

• .ZIP File Format Specification § 4.4.3

Motivation

Directing readers to specific sections of a document, even when you cannot get a deeplink to that section.

Importance

A description of the importance of this change.

Does this feature unlock entirely new use-cases? Or is it possible to achieve the same functionality with existing functionality and this change would improve the user experience?

Alternatives Considered

Putting section in link but then it's unclear .

[d-ronnqvist]

Hi. Thank you for reporting this issue.

Can you describe why this would be an important enhancement and elaborate on why it would be unclear to put the section number in the link text?

With only the Zip File Format Specification example I feel that this can be worked around fairly easily by putting the extra text in the link title. The on-page presentation in mostly the same.

[d-ronnqvist]

To make progress on this issue I feel that we'd need more examples to analyze. Some questions that we'd want to answer include:

• What type of content can come after a link?
• How much content is expected after a link?
• Is there a use-case for putting content before the link?
• Is this only applicable to HTTP/HTTPS links?
• Is this only applicable to See Also sections?

When we have a better understanding of the use-cases we can think of the best way to improve them.