Standardising relative pathnames: Security Best Practices + maybe elsewhere #1359
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Fixes problem reported here on Discord.
TL;DR: Some link syntaxes seem browser dependent & this is an attempt to standardise on a known working syntax for some material I wrote before some standards about inter-document linking were more rigorously applied.
For the link to
Installing the node from source
here, on the live site I've seen it open correctly with the URL into a new window but fail when simply clicking on the link...
or a relative pathname that doesn't begin withdocs
(although/docs
seems to work just as well).I've standardised the Security Best Practices pages which I wrote long ago & which had a hodgepodge of syntaxes, including the Air Gap link to the "Install from source" page that was reported broken above. I've concluded linking to
docs/.../<filename>.md
is canonical because output from this comment generally shows that syntax:after repeated, recent edits by @CarlosLopezDeLara @gufmar on these files which have the most intra-Portal links: and so they are especially welcome to check the syntax changes here. (There are some other edits to bring the content up to date.)