Skip directly to content
Bite-sized thoughts about the web and the people who use it.
April 17, 2014

How simple?

Insultingly simple.

Sometimes when we're working on something complex, we feel like we don't want to dumb it down too much, because we don't want to be deprecating. Nobody wants to be treated like an idiot, right?

Right, but here's the rub. Making things simple doesn't make people feel like idiots. It makes them feel smart!

Have you ever put together a piece of IKEA furniture without even having to consult the instructions? That's an insultingly simple design. And it feels great.

Make your emails simple. Make your code simple. Make your logo simple. Make your documentation simple. Refactor your copy, just like you would your code.

Simplify, then simplify again.

Then simplify again.

April 10, 2014

It's not often that you see the words "Don't Optimize Performance" in a sentence on a web developer's blog, but alas, here they are.

Let me be clear. I like fast-loading websites and snappy smartphone apps. I like using Google Chrome, Sublime Text, and Dropbox because they are faster than Safari, PHPStorm, and swapping out flash drives.

But if you are performance-tuning your website before you even know how slow it is, then you're making a mistake.

It feels good to improve performance because it's discrete and measurable. Shaving milliseconds off a page load can be addicting. But most of us aren't in the business of optimizing page loads… we are trying to optimize an entire web experience, of which performance is only a tiny part.

Yes. People don't like slow websites, but has anybody actually mentioned that your website is slow? Every minute you spend building image sprites, minifying Javascript, and tuning for-loops is time you could be spending on issues that users are actually complaining about, or features they are clamoring for.

Your performance tweaks may fulfill your personal desire to express cleverness or scratch a mental itch, but wasting your client's time and money solving a problem that doesn't exist yet is nothing to be proud of.

When your users are noticing slowness, then yes, of course, fix it. Solve their problem immediately!

Because solving users problems is the business you're actually in.

April 02, 2014

As a web developer, my education has been strongly influenced by information that was freely shared and published online by those who came before me. I read Mark Pilgram's Dive into HTML 5, Jonathon Snooks SMACSS, and Why's Poignant Guide to Ruby. Each of these books was written by a developer, and in the spirit of open source, they were published online so everyone in the community could benefit. I thought it was noble and generous, and I wasn't alone. Thousands read these books and the developers went on to become leaders in their respective communities.

Anyone could publish a book like this (indeed, several of you have), but the barriers are formidable. Instead of just writing the book (which is challenging enough), you'd also have to build the website, do you own design work, get hosting, and provide ongoing maintenance. If you want any special functionality, like the ability to download it in various formats, or support for translated versions, you'd be on your own to build and maintain the tooling to do that.

Enter Bitbooks

I'm currently working on a project called Bitbooks, which aims to make that whole process easier. Bitbooks will be a service that allows developers of any experience level to write and publish a copy of their book online.

How it works

If you've ever used Github pages, then you already know how it works.

You write your book in Markdown, put the files on Github, and point Bitbooks at your repo. Bitbooks will then read the files and use them to build a tastefully designed website -- an online version of your book. This site is pushed to Github pages, which provides free hosting and the ability to use your own domain name. If any updates are made to your content repository, Bitbooks will update your site on Github pages automatically. This lets you make updates or accept changes via pull requests without having to worry about constantly updating your site.

Like Github pages, Bitbooks will provide you with a choice of themes you can use. Here's an early look at what I have in the works:

Glide Theme

Epsilon Theme

Epsilon Theme

Hamilton Theme

Of course, all themes will be fully responsive.

Responsive Themes

From a feature perspective, I'm heavily influenced by what I consider to be the best implementation of an online book: Scott Chacon's Pro Git. Everything about it, from its SEO awareness to its support for downloads in multiple formats are examples to me of what a well implemented build could produce for you.

Why it works

If you're a technical author, then Github is the ideal place for your book, because that's where your audience is. Just look at Getify's You Don't Know JS or Addy Osmani's Developing Backbone.js Applications. Putting their book content on Github lets them write iteratively, get feedback, and collaborate with others. They can go straight to the community instead of working to persuade the community to come to them.

Everything about this authoring process is designed to put you in control. You don't need to create another login or put your stuff in another walled garden. Your content is yours. Your site is yours. If you wanted to use Bitbooks to generate living documentation for your open source project, you could do it. If you wanted your community to collaborate on a written collection of best practices, you could do it. If you want to write fiction you could do it. It's all up to you.

The Open Source Way

This project is founded on the principle that open source makes everything better. Books like Pro Git, and PHP the Right Way have such a wide impact because they give away information freely, opening up the content and source code for anybody to use and share. Paradoxically, the physical versions of these books continue to sell very well.

So, in the spirit of open source, I'll be releasing the static site framework that runs Bitbooks as an open source project called "Franklin."

If Octopress is a static site framework, optimized for blogs, then Franklin will be a static site framework optimized for books. I'll have more details coming soon, so subscribe here if you want to stay in the loop.


I don't believe in The Big Reveal, and that's why I'm talking about this now, while the project is in the building phase. After a couple months of weekend work, I think I'm about 60-70% of the way to an alpha launch. The first round of sites will be made by invitation only, so tell me if you want to participate (and if you do, I will hook you up).

If you're still reading then you probably have some interest in a project like this, so in closing, I have a favor to ask of you: Tell me what you think

Would you use something like this? Is it missing something? Shoot me an email, and help me know if I'm on the right track. You could also tweet at me or leave comments below. However you do it, just say what you're thinking. The more good feedback I get on where this ought to go, the better it will turn out.

And with that, I'll get back to work. With the right tools in place, I believe we can kick off a whole new series of great books and documentation to the benefit of our various technical communities. Let's build something cool, together.