Doc website branches

[John Arbash Meinel]

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


...

> As far as I am aware, plugins are the only way of "adding on" to Bazaar,
> so unless extras means something other than plugins, it is probably safe
> to go with plugins.  Doing this has the advantage of allowing extras to
> be used for something other than plugins should that be needed.

You can interface via the command line, you can interface a few
different ways.

> 
>> OTOH, I'm not 100% sure about how sensible a "Bazaar Add-ons Guide" is.
>> Would it be valuable to have one manual like that documenting each
>> integration with an Editor, IDE, Bug Tracker, CI tool, etc? Or should
>> each of these provide their own doc (not necessarily in ReST) and we
>> make no effort to aggregate them?
>>
>> My other concern is just how large an "Add-ons Guide" could become. Done
>> properly, you'd think that "Bazaar Eclipse Add-on", "Bazaar IntelliJ
>> Add-on", etc. ought to be manuals in their own right. Being honest with
>> ourselves though, it's more likely the doc for each add-on will be
>> "light" given 99% of developers prefer coding to writing manuals. :-)
>> Having an umbrella "Add-ons Guide" might at least encourage *some* docs
>> via copy-and-paste from other add-ons. Not sure.
>>
>> Any opinions?
> 
> The problem for me is that the Bazaar Eclipse plugins (!) and the Bazaar
> IntelliJ IDEA plugins (!) -- note the plural in both cases :-( -- are
> Eclipse and IntelliJ IDEA "add ons" they are not Bazaar "add ons".
> 
> I think treating the editor and IDE world as a separate category is
> probably a good move.

Maybe. I think in the short term having it all under one banner is
better. Even if they end up being full books, they *can* always be just
in another subdirectory of the same project.

> 
>> FWIW, if we decide it's useful, an "Add-ons Guide" is low priority for
>> me. I'm far more motivated to get:
>>
>> 1. better admin documentation (recent list threads have highlighted
>>    our deficiency there)
>>
>> 2. an Explorer User Guide.
>>
>> (And I want a few more things streamlined in Explorer before I start on
>> the latter.)
> 
> I assume you mean Bazaar Explorer and not Windows Explorer here ;-)
> 

He generally does.

John
=:->

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

iEYEARECAAYFAkrq8s0ACgkQJdeBCYSNAAMpjQCcDufeqr5s8MW9zuzf7BiYfexq
L6UAoLsaSQhtww+vyvRlyDQOaBVdEZp5
=NUjd
-----END PGP SIGNATURE-----