All The Tropes:Style Guide: Difference between revisions

Line 84:
[[Pothole]]s are good, while [[sinkhole]]s are bad.
 
[[Pothole]]s are essential on external links. [[Special:Analytics#mw-section-devices|Over half of the people who read All The Tropes use devices that do not allow hovering over links.]] Thus, if we give them a link like [https://www.example.com] or [https://www.example.com here], they have no way of knowing whether that's a poorly-coded link to a page on All The Tropes, a Wikipedia page, a YouTube video, a documentation page for the entire internet, a link to malware, or something else altogether - both of these are the link equivalents to a [[Zero Context Example]], and are also accessibility sins. Providing a quick description is preferred, like this: [https://www.example.com An "example.com" link is itself an example of a link.]
 
Whatever you do, ''don't'' just drop the URL into the text of a page without any markup at all. This is called a "bare URL", and while the wiki software will recognize it and turn it into a clickable link, it's sloppy and lazy and makes you -- and by extension the wiki -- look bad.
Line 90:
To summarize:
* https://www.example.com, without any markup at all, looks like crap;
* [https://www.example.com] or [https://www.example.com here] is bad;
* [https://www.example.com example] is better but excludes people with accessibility issues;
* [https://www.example.com This is an example] is best.