[MERGE] [1.0] Move material out of User Guide into User Reference

Aaron Bentley aaron.bentley at utoronto.ca
Mon Dec 10 14:17:54 GMT 2007


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

Ian Clatworthy wrote:
> Alexander Belchenko wrote:
> 
>> Looks good for me.
>> bb:approve. (Probably someone else should approve this as well).
> 
> I agree. Perhaps Aaron or John could have a look?

bb:comment

Well, to me it seems strange to be moving documentation out of the doc
directory.  That makes it less discoverable.  Also, it was formerly
specified as "doc/en", and now no language is specified.

We also might want to consider using pkg_resources rather than brewing
this ourselves.

And I fear that we're introducing too many ReST-isms into what's
supposed to be plaintext docs.  The headings are fine, but the links are
a problem.  I don't think Bazaar users should be forced to interpret
"See also `Using Hooks <../user-guide/index.html#using-hooks>`_." when
they run "bzr help hooks"

Aaron

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

iD8DBQFHXUqS0F+nu1YWqI0RApGrAJ9+LBjyeny3XaQahbvB8px2SJpxbQCfYtiE
XOYHwawqu4ynnJl8LFqbM3g=
=aYlN
-----END PGP SIGNATURE-----



More information about the bazaar mailing list