Write API docs

[blerg.git] / www / index.html

diff --git a/www/index.html b/www/index.html
index 6b25550..729ff19 100644 (file)
--- a/www/index.html
+++ b/www/index.html
@@ -54,30 +54,30 @@
   <div id="welcome">
   <h2>I am 12 and what is this</h2>
 
-  <p>Blërg is a miniblogging platform.  It's less limited than
-  microblogging platforms like <a
-  href="http://twitter.com/">Twitter</a>, but much simpler than
-  full-blown blogging platforms like <a
-  href="http://wordpress.com/">Wordpress</a> or <a
-  href="http://livejournal.com/">Livejournal</a>.  Blërg is also an open
-  source tagged text database engine written in C that does the back-end
-  work.</p>
+  <p>Blërg is a microblogging platform.  Or maybe a miniblogging
+  platform.  Blërg is not sure.  Blërg is a lot like <a
+  href="http://twitter.com/">Twitter</a>, but aims to fix some of its
+  idiosyncracies.  Blërg does not want to be a full blogging platform
+  like <a href="http://wordpress.com/">Wordpress</a> or <a
+  href="http://livejournal.com/">Livejournal</a>.  Blërg is also an <a
+  href="/doc/">open source tagged text database engine</a> written in C
+  that does the back-end work. Blërg's author finds it entertaining to
+  anthropomorphize Blërg in the third person.</p>
 
   <h2>But what's wrong with Twitter?</h2>
 
-  <p>I'M GLAD YOU ASKED. While I don't believe the basic social premise
-  of Twitter is broken, there are two facets of it that are IMNSHO just
-  wrong:</p>
+  <p>I'M GLAD YOU ASKED. There are two aspects of Twitter that just bug
+  me as an engineer:</p>
   
   <ol>
   <li><strong>Ruby on Rails</strong> - Using rails to prototype a system is
-  fine &mdash; scaling up to a million hits a day with it is just poor
-  engineering. As the service grew, I'm sure it cost them a lot more
-  time than it saved.</li>
+  fine &mdash; scaling up to a million hits a day with it is just a bad
+  idea. As the service grew, I'm sure it cost them a lot more time than
+  it saved.</li>
   <li><strong>140 characters is not enough</strong> - I routinely write
-  sentences longer than 140 characters, so I can't imagine even beginning to
-  make a point in such a small space.  This textual confinement has led to the
-  rise of URL shorteners, which are <a
+  sentences longer than 140 characters, so I can't even begin to imagine
+  making a point in such a small space.  This textual confinement has
+  led to the rise of URL shorteners, which are <a
   href="http://bytex64.net/blog/e2256">breaking the internet</a>.
   </ol>
 
@@ -100,6 +100,11 @@
   fully functional service created in a fit of hubris to poke fun at Twitter's
   engineering.  It's just for fun, but no one is going to keep you from using
   it seriously. :]</p>
+
+  <h2>Tell me more about this database engine.</h2>
+
+  <p>Here, take a look at the <a href="/doc/#design">design docs</a>.</p>
+
   </div>
 
   <div id="navigation">