Clean up some content

Includes:

- Listing more related posts
- Fixing broken links
- Improving markdown format in various places

_pages/about.md

@@ -24,6 +24,6 @@ I'm a husband and father. I'm [INTJ](https://www.16personalities.com/intj-person
 
 ## This site
 
-This site is built with [Jekyll](https://jekyllrb.com/) and hosted on [Github Pages](https://pages.github.com/). The main fonts are [PT Sans](https://fonts.google.com/specimen/PT+Sans) and [PT Serif](https://fonts.google.com/specimen/PT+Serif). There's also a [styleguide](/styleguide/md).
+This site is built with [Jekyll](https://jekyllrb.com/) and hosted on [Github Pages](https://pages.github.com/). The main fonts are [PT Sans](https://fonts.google.com/specimen/PT+Sans) and [PT Serif](https://fonts.google.com/specimen/PT+Serif). There's also a [styleguide](/styleguide).
 
 All the code is open-source, and [available on Github](https://github.com/bryanbraun/bryanbraun.github.io), released under the [MIT license](https://github.com/bryanbraun/bryanbraun.github.io/blob/master/license.md). All content is licensed with a [Creative Commons Attribution License (BY 4.0)](https://creativecommons.org/licenses/by/4.0/), unless otherwise noted. If you find anything you can improve about this site, please submit a pull request.

_posts/2011-02-06-jolly-ranchers.md

@@ -1,7 +1,9 @@
 ---
-layout: post
 title: "Jolly Ranchers"
 date: 2011-02-06 16:43:04
+related: [
+  "Tetris"
+]
 ---
 
 I confess that over the past year or so, I got into a really bad habit of sleeping through my alarm clock. Oh, I usually hear it. It wakes me up but I ignore it or I procrastinate getting out of bed until I drift back to sleep.
@@ -22,4 +24,4 @@ Now I have so much more time in the morning. Most days I get to spend 2 hours ju
 
 Here's the point. Is my life better because of the Jolly Ranchers? Technically yes, but really, it isn't the Jolly Ranchers that did it. Jolly Ranchers may not help YOU get up in the morning, just like drinking lots of water didn't help ME (thanks anyways Bart). The victory comes when you keep trying things over and over, for days, weeks, even months, until you find what works. When something fails, come up with something else. Do it again. Do it again. Do it again.
 
-We've all got demons to conquer. Sleeping in, smoking, eating out, watching too many movies, forgetting things, overcommitments, surfing the internet at work, missing foul shots, dropping your cellphone, swearing, road rage, belching, racist jokes, burning the dinner, jaywalking, too much video games, listening to loud music, blowing off homework, sleeping in class, spreading rumors, walking on the grass, using non-fluorescent light bulbs, drinking out of the milk jug, or forgetting people's names. We can nix our weaknesses one at a time if we are willing to try again and again to beat them.
+We've all got demons to conquer. Sleeping in, smoking, eating out, watching too many movies, forgetting things, overcommitments, surfing the internet at work, missing foul shots, dropping your cellphone, swearing, road rage, belching, racist jokes, burning the dinner, jaywalking, too much video games, listening to loud music, blowing off homework, sleeping in class, spreading rumors, walking on the grass, using non-fluorescent light bulbs, drinking out of the milk jug, or forgetting people's names. We can nix our weaknesses one at a time if we are willing to try again and again to beat them.

_posts/2012-10-25-open-source-community-embraces-designers-most-wins.md

@@ -1,7 +1,9 @@
 ---
-layout: post
 title: "The open source community that embraces designers most, wins."
 date: 2012-10-25 05:08:30
+related: [
+  "Vim Color Schemes: A Call for Designers"
+]
 ---
 
 That's my theory. Here's my reasoning:
@@ -22,9 +24,9 @@ If you have tried to use any of this software, I think you'll quickly notice whe
 
 (note: by just glancing at the websites of the projects I've mentioned, the lack of contributing designers is evident. Only one site really outshines these rest... <a href="http://www.mozilla.org" target="_blank" title="If you click the products tab, you'll see that all their products sites are amazingly designed.">Mozilla's</a>. I cannot speak for their contribution processes, but clearly, they got designers involved somewhere along the way. And with designers on board, is it any surprise that they were the ones that got mass market penetration? Not to me.)
 
-Fantastic links from <a href="https://plus.google.com/+ChrisMessina" target="_blank" title="Chris Messina is awesome. You should all follow him on Google+">an expert</a> on these topics:
+Fantastic links from <a href="https://plus.google.com/+ChrisMessina" title="Chris Messina is awesome. You should all follow him on Google+">an expert</a> on these topics:
 
-*   <a href="http:// http://factoryjoe.com/blog/2005/11/21/open-source-design-20/" target="_blank" title="Open Source Design">http://factoryjoe.com/blog/2005/11/21/open-source-design-20/</a>
-*   <a href="http://factoryjoe.com/blog/2008/01/03/the-problem-with-open-source-design/" target="_blank" title="The Problem with Open Source Design">http://factoryjoe.com/blog/2008/01/03/the-problem-with-open-source-design/</a>
-*   <a href="http://factoryjoe.com/blog/2009/08/26/losing-my-religion/" target="_blank" title="Losing My Religion">http://factoryjoe.com/blog/2009/08/26/losing-my-religion/</a>
-*   <a href="http://factoryjoe.com/blog/2009/11/07/open-source-design-and-the-openofficemouse/" target="_blank" title="Open Source Design and the Open Office Mouse">http://factoryjoe.com/blog/2009/11/07/open-source-design-and-the-openofficemouse/</a>
+* <a href="http://factoryjoe.com/blog/2005/11/21/open-source-design-20/" title="Open Source Design">http://factoryjoe.com/blog/2005/11/21/open-source-design-20/</a>
+* <a href="http://factoryjoe.com/blog/2008/01/03/the-problem-with-open-source-design/" title="The Problem with Open Source Design">http://factoryjoe.com/blog/2008/01/03/the-problem-with-open-source-design/</a>
+* <a href="http://factoryjoe.com/blog/2009/08/26/losing-my-religion/" title="Losing My Religion">http://factoryjoe.com/blog/2009/08/26/losing-my-religion/</a>
+* <a href="http://factoryjoe.com/blog/2009/11/07/open-source-design-and-the-openofficemouse/" title="Open Source Design and the Open Office Mouse">http://factoryjoe.com/blog/2009/11/07/open-source-design-and-the-openofficemouse/</a>

_posts/2012-11-25-vim-color-schemes-call-designers.md

@@ -1,21 +1,23 @@
 ---
-layout: post
 title: "Vim Color Schemes: A Call for Designers"
 date: 2012-11-25 19:28:30
+related: [
+  "The open source community that embraces designers most, wins."
+]
 ---
 
-Sometimes I'm knee deep in technology and I come across a situation where my eyes are insulted by a deluge of terrible design. Once it was in finding <a href="http://www.georgehutchins.com/" target="_blank" title="The flaming counter at the bottom of the page sure takes me back.">this website</a>. Most recently, it was in browsing color schemes for Vim, a command line based text editor.  
-  
+Sometimes I'm knee deep in technology and I come across a situation where my eyes are insulted by a deluge of terrible design. Once it was in finding <a href="http://www.georgehutchins.com/" title="The flaming counter at the bottom of the page sure takes me back.">this website</a>. Most recently, it was in browsing color schemes for Vim, a command line based text editor.  
+
 For background, Vim lets you create and edit text files in a command line, and "color schemes" exist to highlight the words you're typing with different colors. If you are a developer, it makes sense, but to non-developers, it's the equivalent of highlighting your sentences so all the nouns are one color, verbs are another color, punctuation another color, (and so on…). The overall effect makes the the code easier to understand. And let me tell you… every little bit helps.  
-  
+
 Anyways, there are tons of options for color schemes but this is what you find when you browse them.
 
-<img alt="See the full listing at http://code.google.com/p/vimcolorschemetest/" src="/assets/images/vim_color_schemes_sm.png" style="width: 800px; height: 433px;" />
+<img alt="See the full listing at http://code.google.com/p/vimcolorschemetest/" src="/assets/images/vim_color_schemes_sm.png" />
 
 Seriously? I mean, I get that the project is [open source][1], which has the side effect of inviting in the unfinished whims of the hobbyists everywhere but this is just absurd. Just look at the blue one in the top right. It's hard for me to believe that there are people out there who make these designs and aren't too embarrassed to publicly contribute them. I look at these and think that all it would take is for a designer to come in and pop out three or four polished designs in a weekend and just clean up shop. Such a contribution would quickly bubble to the top, since everybody wants a better experience. Right?  
-  
+
 To be fair, with a bit of digging, I did find a couple (like <a href="http://dengmao.wordpress.com/2007/01/22/vim-color-scheme-wombat/" target="_blank" title="This is the one I decided to go with.">Wombat</a> and <a href="http://blog.toddwerth.com/entries/8" target="_blank" title="The IR Black Vim Color Scheme">IR Black</a>) that weren't too bad.  
-  
+
 I'm starting to realize that some developer circles turn a blind eye to design. Almost as if the ability to do visual design was below them. Or maybe they feel like it isn't the kind of skill that you can study and develop in yourself… that it's something you must be born with. My message to people with these kind of attitudes is that you are only hurting yourselves. Sure, it may not be wise to aspire to be an expert in everything, but a putting a little effort into learning design principles can go a long way.
 
- [1]: http://bryanbraun.com/2012/10/25/open-source-community-embraces-designers-most-wins "And I've already discussed how open source has a tendency to repel the designers they need most..."
+ [1]: http://bryanbraun.com/2012/10/25/open-source-community-embraces-designers-most-wins "And I've already discussed how open source has a tendency to repel the designers they need most..."

_posts/2013-01-24-usability-20.md

@@ -1,9 +1,13 @@
 ---
-layout: post
 title: "Usability 2.0"
 date: 2013-01-24 18:00:15
+related: [
+  "The open source community that embraces designers most, wins."
+]
 ---
 
-With the proliferation of apps and a new generation of web services, the bar for software usability has been raised. If your software isn't simple enough to use, 
+With the proliferation of apps and a new generation of web services, the bar for software usability has been raised. If your software isn't simple enough to use, [it will be replaced](http://dilbert.com/blog/entry/botched_interface_market/) and obsolete in a few short years.
 
-<a href="http://dilbert.com/blog/entry/botched_interface_market/" target="_blank">it will be replaced</a> and obsolete in a few short years. Some used to believe that the complexity of the task being done (accounting, 3D Modeling, statistics, etc.) forced the software to be complex. That was before products like <a href="http://mint.com" target="_blank">Mint</a>, <a href="http://www.apple.com/ilife/imovie/" target="_blank">iMovie</a>, and <a href="http://mailchimp.com/" target="_blank">Mailchimp</a> proved them wrong. How simple is good enough? If it requires to user to read documentation, it isn't good enough.
+Some used to believe that the complexity of the task being done (accounting, 3D Modeling, statistics, etc.) forced the software to be complex. That was before products like [Mint](http://mint.com), [iMovie](http://www.apple.com/ilife/imovie), and [Mailchimp](http://mailchimp.com) proved them wrong.
+
+How simple is good enough? If it requires to user to read documentation, it isn't good enough.

_posts/2013-07-02-simplicity-takes-restraint.md

@@ -1,6 +1,10 @@
 ---
 title: Simplicity Takes Restraint
 date: 2013-07-02 14:43:19
+related: [
+  "Visual attention is a zero-sum game",
+  "No Sidebars"
+]
 ---
 
 If the goal of your site design is simplicity (and it probably is if you are using this theme), then don't forget: Simplicity takes restraint.

_posts/2013-07-13-err-on-the-side-of-simplicity.md

@@ -1,17 +1,10 @@
 ---
-layout: post
 title: "Err on the side of simplicity"
 date: 2013-07-13 20:59:15
 ---
 
-<p class="p1">
-  It's hard to go wrong in your web project if you err on the side of simplicity. That goes for both on the design side and development side.
-</p>
+It's hard to go wrong in your web project if you err on the side of simplicity. That goes for both on the design side and development side.
 
-<p class="p1">
-  You can't do everything at once, so don't. Build the essential parts and make them look really clean. It's easier to add more later than it is to take something away (if not for technical reasons, then for <a href="http://www.bryanbraun.com/2011/04/10/bryan-vs-the-sunk-cost-fallacy" title="Sunk costs strike again.">emotional reasons</a>).
-</p>
+You can't do everything at once, so don't. Build the essential parts and make them look really clean. It's easier to add more later than it is to take something away (if not for technical reasons, then for <a href="http://www.bryanbraun.com/2011/04/10/bryan-vs-the-sunk-cost-fallacy" title="Sunk costs strike again.">emotional reasons</a>).
 
-<p class="p1">
-  It means less noise. Less distraction. Less delay in shipping your <a href="http://en.wikipedia.org/wiki/Minimum_viable_product" target="_blank" title="Minimum Viable Product">MVP</a>.
-</p>
+It means less noise. Less distraction. Less delay in shipping your <a href="http://en.wikipedia.org/wiki/Minimum_viable_product" title="Minimum Viable Product">MVP</a>.

_posts/2013-07-14-tetris.md

@@ -1,7 +1,9 @@
 ---
-layout: post
 title: "Tetris"
 date: 2013-07-14 19:03:07
+related: [
+  "Jolly Ranchers"
+]
 ---
 
 <p class="p1">
@@ -22,4 +24,4 @@ date: 2013-07-14 19:03:07
 
 <p class="p1">
   I love life.
-</p>
+</p>

_posts/2013-08-30-visual-attention-is-a-zero-sum-game.md

@@ -1,7 +1,10 @@
 ---
-layout: post
 title: "Visual attention is a zero-sum game"
 date: 2013-08-30 06:57:38
+related: [
+  "No Sidebars",
+  "Simplicity Takes Restraint"
+]
 ---
 
 The amount of attention a person allocates to your webpage is fixed, and you decide how that attention is distributed.
@@ -14,7 +17,7 @@ Distributing attention like this can turn into an arms race. More bold! More con
 
 Instead of bolding the word in the first place why not reduce the importance of everything else? It has the same effect on attention, but it drives towards simplicity instead of complexity, like the home page at [dropbox.com](http://dropbox.com).
 
-<img alt="" src="/assets/images/dropbox-home.png" />
+![Dropbox.com homepage, circa 2013](/assets/images/dropbox-home.png)
 
 Visual attention is a zero sum game. If everything is important, than nothing is.
 

_posts/2013-11-01-put-the-hours-in.md

@@ -1,17 +1,14 @@
 ---
-layout: post
 title: "Put the Hours in"
 date: 2013-11-01 19:56:34
+related: [
+  "Don Hertzfeldt on Creative Work",
+  "It's about the Miles"
+]
 ---
 
-<p class="p1">
-  Anything worth doing takes more than an afternoon.
-</p>
+Anything worth doing takes more than an afternoon.
 
-<p class="p1">
-  Anything worth learning cannot be won without a struggle.
-</p>
+Anything worth learning cannot be won without a struggle.
 
-<p class="p1">
-  So struggle, be patient, and put the hours in.
-</p>
+So struggle, be patient, and put the hours in.

_posts/2015-06-17-no-sidebars.md

@@ -1,7 +1,14 @@
 ---
-layout: post
 title: "No Sidebars"
 date: 2015-06-17 00:13:40
+related: [
+  "Visual attention is a zero-sum game",
+  "Simplicity Takes Restraint"
+]
 ---
 
-I was talking about the Writer theme at a meetup once when a developer asked me if it was possible to set up a sidebar for the theme. I said no way, not today, and not ever. Why? Because sidebars tend to be a dumping ground for unimportant things that nobody wants to look at. It would be bad enough if they were value-neutral, but they impose a tax on all other page content, drowning out the message you are trying to share. To me, sidebars represent the unquestioned patterns that result in unnecessary friction and cruft (both on the web and in life). And <a href="http://nosidebar.com/about/">I'm not the only one who thinks this way</a>. Writer's lack of sidebars is a feature. Don't be afraid to throw out your sidebar. I'm confident you won't miss it at all.
+I was talking about the Writer theme at a meetup once when a developer asked me if it was possible to set up a sidebar for the theme. I said no way, not today, and not ever.
+
+Why? Because sidebars tend to be a dumping ground for unimportant things that nobody wants to look at. It would be bad enough if they were value-neutral, but they impose a tax on all other page content, drowning out the message you are trying to share. To me, sidebars represent the unquestioned patterns that result in unnecessary friction and cruft (both on the web and in life). And <a href="http://nosidebar.com/about/">I'm not the only one who thinks this way</a>.
+
+Writer's lack of sidebars is a feature. Don't be afraid to throw out your sidebar. I'm confident you won't miss it at all.

_posts/2016-02-08-don-hertzfeldt-on-creative-work.md

@@ -1,7 +1,9 @@
 ---
-layout: post
 title: "Don Hertzfeldt on Creative Work"
 date: 2016-02-08 22:48:08
+related: [
+  "Put the Hours in"
+]
 ---
 
 I pulled [this gem][1] from [a Don Hertzfeldt AMA][2]:
@@ -10,9 +12,9 @@ I pulled [this gem][1] from [a Don Hertzfeldt AMA][2]:
  [2]: https://www.reddit.com/r/IAmA/comments/31g6qc/i_am_a_don_hertzfeldt_filmmaker_ama/
 
 > anything creative is going to take a ton of work.... like actual daily work, animating, or constantly practicing your guitar, or whatever it is. that's 95% of the job...the really boring busywork that you grind out. for the animator, it's telling a story one frame at a time. and that i often have to force myself to do because it's often so boring or lonely.
-> 
+>
 > the inspiration part of it all is the other 5%. and it is very important but if you don't do all of that other work, it doesn't matter how great your ideas are. this is also the part that can't really be forced. you can't force yourself to write or come up with ideas. it's something that comes naturally. luckily, while you are grinding out the other miserable 95% of the job, it provides for a lot of time for those ideas to come drifting in.
 
 It's strangely reassuring to know that there are no shortcuts, even for [him][3].
 
- [3]: https://en.wikipedia.org/wiki/Don_Hertzfeldt
+ [3]: https://en.wikipedia.org/wiki/Don_Hertzfeldt

_posts/2016-09-21-its-about-the-miles.md

@@ -1,7 +1,10 @@
 ---
-layout: post
 title: "It's about the Miles"
 date: 2016-09-21 09:30:42
+related: [
+  "Put the Hours in",
+  "Don Hertzfeldt on Creative Work"
+]
 ---
 
 Last week I ran my 4th marathon.
@@ -20,4 +23,4 @@ It didn't matter that the weather was warm, with 94% humidity. It didn't matter
 
 I'm a big believer in the unglamorous consistent [grinding effort][1] that we often don't see behind the moments of triumph. I'm going to back off of running for a while, but whatever I end up doing instead, you can bet I'll be planning on putting in the miles.
 
- [1]: http://www.bryanbraun.com/2016/02/08/don-hertzfeldt-on-creative-work
+ [1]: http://www.bryanbraun.com/2016/02/08/don-hertzfeldt-on-creative-work