Distilled Hype by Kahlil Lechelt

Maintainable Style Guides

Where I work we have been working on a living style guide for a while on the basis of Node.

This was how it worked: you would have one Markdown document, that document would contain CSS selectors that corresponded to components on your website, some text documenting the components and the respective URL where those components would be found. The Node program would then load the page in PhantomJS, make screenshots of the UI components, parse out the CSS snippets for the different components, then insert them into the markdown document and then render everything into HTML. The prototype we had running actually did a decent job at it.

Unfortunately two of the main devs working on it left and I just had too much other stuff on my plate at this point to continue working on it.

I still love the idea though. I think a living style guide should be an essential part of every long running project.

Just yesterday I read Ian Feather's article on "A Maintainable Style Guide" and how they built one at Lonely Planet. I find their way of doing it actually very compelling.

Basically they refactored their application templates to be highly componentized, focused and testable and then just used the exact same templates they used in the app to render their style guide.


Of course this means there is no boilerplate-framework-thingie that they can put out for everybody to use. This approach is customized to your technical stack but it sounds absolutely beautiful to use once you have it set up.

Go ahead and read all about it.

Web Components Can Do That?! by @addyosmani →


Amazing slides from Addys talk about Web Components. Just by going through the slides you will get an overview over what is possible with Web Components today. So if you didn't care to look into that yet this is the perfect update for you.

I really hope they will release a video of the talk as well.

DHH Talks TDD On RailsConf →

I have never practiced TDD but I watched this talk anyway because it's always great to see DHH talk! What he says about TDD makes a lot of sense to me. I love his perspective on programming because it mirrors mine pretty well.

There is always a lot to learn about giving talks from DHH as well. Note how well his story is constructed and how easy it seems for him to make very clear points. Definitly worth a watch.

Human JavaScript

Human JavaScript is a book written by Henrik Joreteg. I just finished it and I must say that I really enjoyed it. Henrik proposes a specific architecture for pure JavaScript apps that are especially "human friendly". Meaning the code is easy to understand and to maintain. He uses Browserify, Backbone and slightly modified BackboneJS models and views which he calls "Human Views" and "Human Models".

The book is very well written and if you have gaps in your MVC knowledge like me, this book will definitely close some for you.

I am very intrigued by this app architecture and will definitely try it out in a side project soon. I have a hunch that this might be a wonderful fit for Hoodie apps as well.

If you are interested in JavaScript app architectures I highly recommend you read this book. Get it at humanjavascript.com.