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

Aaron Bentley aaron.bentley at utoronto.ca
Tue Dec 11 13:58:12 GMT 2007


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

Alexander Belchenko wrote:
> Aaron Bentley пишет:
>> If we have a doc directory,
>> people will look there for documentation.  If they can't find what
>> they're looking for there, many will assume that the documentation they
>> are looking for does not exist.
> 
> I disagree.
> Let's define what's main primary documentation intended to users
> and what's our internal thing. Currently all texts are our internal
> thing -- from text and python sources we generate full set of html
> documentation.

In my view, the ReST versions are not an internal thing.  Many
commandline users prefer plaintext, and the ReST versions of the files
are useful to them.

> Let's define policy here and make clear distinction: what should be in
> distributive (including release tarball) and what should be in bzr.dev
> sources.

Well, I don't know what you want to put on Windows, but I definitely
think we should be shipping plaintext documentation on Unix.

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

iD8DBQFHXpd00F+nu1YWqI0RAtaiAJ9HWXa4Yev1f8gS3rrP+u6r3YL5SgCcC5aS
hg9xM4jym0jN6MkfQtup5pI=
=5g/7
-----END PGP SIGNATURE-----



More information about the bazaar mailing list