# HG changeset patch
# User Steve Losh <steve@stevelosh.com>
# Date 1276573080 14400
# Node ID cf64f6f74ad3791e4957dd7c4d60d529a6dcd517
# Parent  289163ebca262dacf6fee63b662333b1bbfe6031
docs: more doc work

diff -r 289163ebca26 -r cf64f6f74ad3 docs/concepts.rst
--- a/docs/concepts.rst	Mon Jun 14 23:22:33 2010 -0400
+++ b/docs/concepts.rst	Mon Jun 14 23:38:00 2010 -0400
@@ -1,9 +1,36 @@
 Concepts
 ========
 
+You're not perfect.
+
+Your code is not perfect.
+
+If you're the only person that's read your code, it's wrong. Period.
+
+As developers we need to review each other's code. This helps us catch errors
+before they find our users. It also makes us take greater care when writing
+code because we know someone will most definitely be looking at it.
+
 Code Review Basics
 ------------------
 
+The simplest form of code review is asking a friend to look at the code you
+just wrote. Often a second set of eyes can find problems you might not have
+seen, especially if that person has more experience than you.
+
+Unfortunately, this isn't always practical. You might work remotely with people
+thousands of miles away and not have a chance to simply turn around and say:
+"Hey, could you look at this?"
+
+Code review tools (like hg-review) exist to make reviewing other people's code
+easier.
+
+Their goal is to make it as easy as possible to tell another developer: "No,
+you did *this* wrong.  Fix it."
+
+Other Code Review Tools
+-----------------------
+
 Distributed Code Review
 -----------------------
 
diff -r 289163ebca26 -r cf64f6f74ad3 docs/hacking.rst
--- a/docs/hacking.rst	Mon Jun 14 23:22:33 2010 -0400
+++ b/docs/hacking.rst	Mon Jun 14 23:38:00 2010 -0400
@@ -7,3 +7,5 @@
 Testing
 -------
 
+Documentation
+-------------
diff -r 289163ebca26 -r cf64f6f74ad3 docs/publish.sh
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/publish.sh	Mon Jun 14 23:38:00 2010 -0400
@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+
+make html
+rsync --delete -az _build/html/ ~/src/sjl.bitbucket.org/hg-review
+hg -R ~/src/sjl.bitbucket.org commit -Am 'hg-review: Update documentation.'
+hg -R ~/src/sjl.bitbucket.org push