📕 subnode [[@s5bug/shortlinks]]
in 📚 node [[shortlinks]]
Shortlinks
- A way of referencing URLs without typing out the full domain.
- Common shorthands for websites are mutually agreed upon.
-
Commonly:
gh/[user]/[repo]#[issue]
links tohttps://github.com/[user]/[repo]/issues/[issue]
:repo
andissue
are omittable in the case that only a user or only a repository are wanted to be linked to.- Same for
gl
but to GitLab instead of GitHub. - Same for
gd
but to GitDab. tw/[user]
links tohttps://twitter.com/[user]
.sw/[id]
links tohttps://steamcommunity.com/sharedfiles/filedetails/?id=[id]
.
- References to the [[Agora]] could also be made shortlinks, perhaps
ag/[node]
? -
Shortlinks aim to emulate the automatic link replacements of the website
in question.
gh/[content]
should behave the same as if[content]
was posted on GitHub itself.tw/[user]
should replace the functionality of mentioning@user
on Twitter.
Shortlink Guidelines
-
Shortlinks should start with an identifier and a slash, such as
tw/
orabc/
.- The identifier is not restricted to two characters, but most common ones can be condensed to two characters.
- Shortlinks should not be URIs themselves.
- Shortlinks should not obfuscate content, like a traditional link shortener.
📖 stoas
- public document at doc.anagora.org/shortlinks
- video call at meet.jit.si/shortlinks