[MERGE] Documentation for integration with bzr

[Aaron Bentley]

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

Martin Albisetti wrote:
> On Sat, Apr 5, 2008 at 12:18 PM, Aaron Bentley <aaron at aaronbentley.com> wrote:
>>  To me, this was exactly the kind of document that belonged on the wiki--
>>  a collaborative, utterly incomplete, just-the-basics document.
> 
> Well, many people are starting to use this, specially in IDE
> integration, so if this is already being used, it should be included
> in the developer docs.

I don't think that necessarily follows.  What's wrong with providing it
in the wiki?  It's not docs for developing Bazaar, it's docs for people
who want to use bzrlib.

> Personally, I find incomplete docs much better than nothing at all,

Me too.  But we already have much better than nothing at all.  We have
the wiki.

Moving the document to the source tree makes it harder to make changes.
 It's a chilling effect.  I think that moving it to the source tree at
this stage will prevent us from getting a bunch of positive
contributions from wiki users.

> Not sure this is necessarily a problem.

Yes, it's a problem.  One of them mentions iter_changes, and the other
one doesn't.  There should be a single place (preferably earlier on)
that explains how to compare trees, and later sections should refer to it.

> Done, attached.

Thanks.

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

iD8DBQFH96ng0F+nu1YWqI0RAogzAJkBzhClnaRDlLuvjjO+AntH1LmLxQCbB4LW
ppc8wleLNLxH7Ub5pgGV140=
=PIfV
-----END PGP SIGNATURE-----