[MERGE] repository docs

[John Arbash Meinel]

John Arbash Meinel has voted +1.
Status is now: Approved
Comment:
For some reason I'm not getting the BB emails...

Anyway, overall I think this is a nice overview, and would really like 
to see it merged.

you have:
+                     was fast enough dirstate might be able to be 
simpler/

You probably don't want the trailing slash.

Also, there is another reason to cache these things locally. In that a 
lightweight checkout can perform the operation without having to connect 
to the remote machine at all. (ATM everything does because opening a WT 
automatically connects to the Branch and Repository, but status doesn't 
have to read anything, and diff only needs to read if things have 
actually changed).  "shallow branches" may remove the need for any of 
it, though.

Just something you might want to mention.

For details, see: 
http://bundlebuggy.aaronbentley.com/request/%3C1184234952.12144.104.camel%40localhost.localdomain%3E