CSS Themes Should Be Better


This document was written by me, emsenn, and is released for the benefit of the public under the terms included in the "License" supplement. It was made possible with financial contributions from humans like you. Please direct comments to my public inbox or, if necessary, my personal email.

CSS Themes Should Be Better

I've just begun teaching myself about website development, but I'm already beginning to form opinions:

If you're going to release your CSS stylesheet(s) as a theme, intended for use on more than a single website, you should prioritize following industry standards and guidelines. I understand, for a single site that might get a hundred visitors, make things pretty however works.

But if you intend to distribute the theme, or use it on a site of any popularity, you need to think about how that amplifies any shortcut or oversight you've made.

I started thinking about this when learning to use the [Gutenberg static site generator](https://getgutenberg.io) and looking at the themes available for it. (And later, for Hugo and Jekyll.)

A lot of them are really bad in this regard. Many don't use semantic tags like <header> and <section>

Frankly, I don't see the excuse. It's trivial to type id="{{page.slug}}" or add in conditionals for ograph data. Just… do it. I'm a novice, and I am.

I'm on a rant now so just ignore me if you want, but for real, no one with their priorities straight gives a shit if your website builds in 200ms or 2 seconds. They don't even really know what "build" means. They'll give you the inch of agreeing to use markdown to write their pages. They'll even learn to do weird {{ shortcodes }}. But then you have to make sure their images and descriptions show up right on Facebook shares, and they can drop in their SaaSy widgets.

This is why I'm so in love with Netlify at the moment - I haven't been using them long enough and I'm too ignorant to know about the tech, but their marketing really does a good job of hitting the market's pain points and resolving them. And what they're offering isn't much different than what a bunch of other folk offer. But it's different enough that they just fit into the market better.



This document was made possible with contributions from humans like you. Thank you! I currently accept contributions through the following platforms:

If there is another service through which you'd like to contribute, please send an email. Please note that in accordance with my personal directives #003 and #018, I release all useful information I create for free, so financial contributions do not entitle you to access to any "exclusive content."


Copyright 2019 emsenn

Permission is hereby granted, free of charge, to any person obtaining a copy of this document and associated media files (the "Document"), to deal in the Doftware without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Doftware, and to permit persons to whom the Doftware is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

The Document is provided "as is," without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, or noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort, or otherwise, arising from, out of or in connection with the Document or the use or other dealings in the Document.

Date: 2018-07-14

Author: emsenn

Created: 2019-05-03 Fri 12:39