Doc review & quick ref card - anyone with some DTP skills?

[Aaron Bentley]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Sabin Iacob wrote:
> Aaron Bentley wrote:
>> There are some line-spacing issues:
>> - - the example text seems to have too little whitespace between lines,
>>   especially on FF.
>> - - the example text should be closer to its heading than to the
>> following
>>   heading.
>>   
> 
> somewhat fixed

The association of examples to their headings is much improved.

The line-spacing within examples still looks tight.  For example, under
"Existing project", the "y" of "myproject" almost touches the i of "init".

>> * I think we should favour short options when they exist, e.g. for
>>   the bundle example.
>>   
> 
> in "bundle"'s case it was ok, but for commit, branch, remove, update,
> the short aliases (ci, get/clone, rm, up) may be confusing to the
> non-hardcore user :)

I think Ian meant short options, not short aliases.  For bundle, he'd
like to see "-o", not "--output".

Personally, I think the long options telegraph the meaning better.

Aaron
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFGp0mh0F+nu1YWqI0RArYWAJ9QfYbOWmgkp2/Cs6vp5VxeZ2V94QCcDAcN
6O2Fp8qiGXzgFUzaDe1vH44=
=ytP7
-----END PGP SIGNATURE-----