[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