Getting started with bzr-svn (was Re: bzr-svn and subversion revisions)

[Ian Clatworthy]

John Szakmeister wrote:
> On Mon, Sep 7, 2009 at 7:41 AM, Jelmer Vernooij<jelmer at vernstok.nl> wrote:
> [snip]
>> Newer versions of bzr-svn won't change the mainline history in
>> Subversion by default. Instead, they'll print an error when you would
>> be about to do so and require you to set a configuration variable
>> ("append_revisions_only").
> 
> *Sweet!*  Does this mean that we can repeatedly merge from the
> mainline, and push with no ill effects?  If so, that's really nice.
> 
> Seriously, what's the best way to start documenting something?
> Patches to bzr-svn?  Is there a preferred method (Sphinx, just plain
> reST, etc)?

John,

The preferred place for documentation is here:
http://doc.bazaar-vcs.org/migration/en/, under the
"Bazaar on Subversion Projects" link. Right now, it's a copy of what's
in the User Guide but I'd like to see it greatly enhanced to answer many
of the questions people are asking in this thread. (In contrast, the
material in the User Guide should remain just the bare introduction for
any of the plugins, bzr-svn included.)

The master source can be downloaded from the "improve these documents"
link at the bottom of the page above. The format is Sphinx-style ReST.
There's a link in the sidebar to see the source for each document if
you're curious.

I'd *really* appreciate some help getting good documentation together
for users looking to switch from Subversion to Bazaar. The audience for
this material is huge but I lack the time and expertise in svn to write it.

Ian C.