Wikivoyage:Avoid HTML

From Wikivoyage
(Redirected from Html)
Jump to: navigation, search

The MediaWiki software allows editors to mix in HTML markup along with standard Wiki markup. In general, HTML should be avoided, for the following reasons:

  • HTML is hard to edit. Wiki markup is designed specifically for editing on-screen in a browser, and to be really easy to edit. HTML is not. It intimidates casual editors and keeps them from making improvements to our content.
  • It's a rathole. Fixing up HTML formatting hoohaw wastes time and attention that could instead be spent making valuable content.

If HTML must be used for formatting reasons, it's hidden "behind the scenes" with Mediawiki templates whenever possible. For example, disclaimers should be added with Template:Disclaimerbox and country quickbars with Template:Quickbar, not by adding raw HTML. Not only is this more user-friendly, but it allows updating the design of all boxes or bars in one place. About the only common exception to this is a non-breaking space recommended to prevent elements being "orphaned" on a new, separate line: " "

Make any other exceptions with extreme prejudice.