How's the Bazaar website going?

[Emma Jane]

On Wednesday 19 August 2009 7:50:48 pm Ian Clatworthy wrote:
> Emma Jane wrote:
> I think the new website should refer to the newer documents first and
> foremost. Those documents can then point back to the Wiki content if
> appropriate.

I think you mean "official documentation" when you say newer?

> With the exception of the table of contents in the Plugins Guide, I
> don't see a lot of duplication between it and the website. I think we
> still need to maintain a plugins registry that anyone with a (Wiki)
> login can edit, separate to any more formal documentation on the popular
> plugins themselves.

One of the advantages of having entry points in the Wiki is that this is how I 
first got involved in the project: by writing a Wiki page for the plugins I was 
using. It would be fantastic if we could map out the whole site and where you 
see the official documents and the Wiki documents co-existing. Right now I'm not 
even sure that I'm aware of all of the awesome new documentation that you're 
writing!!


> It would be cool to move to a more database-centric
> plugins registry that allowed ratings, comments, etc (ala
> addons.mozilla.org) instead of a Wiki page but that's certainly not in
> scope for 2.0.

My plan is to break the table into multiple smaller pages by category and to 
expand the space for each of the plugins. Right now it's very difficult to 
entice people to add documentation (or to even understand where they should 
put it). Sometimes there is more information as part of the actual project, 
but nothing on the Web to evaluate if a plugin is appropriate. I don't want to 
replicate work that you are also doing though.



> I see a lot more duplication between the Data Migration Docs I've been
> working on (http://doc.bazaar-vcs.org/migration/en/index.html) and the
> current Wiki content:
>
> * http://bazaar-vcs.org/BzrMigration should be merged into the Data
>   Migration Guide
>
> * http://bazaar-vcs.org/BzrSwitching and subpages should be merged into
>   the Survival Guide.

Ah. I was going to use some of this text in the new landing page for Bazaar 
Switcher Guides (one of the links from the front page). Have you taken a look 
at the page I've been working on which shows where people go from the front 
page?
http://bazaar-vcs.org/BazaarHomePageText


> I'm really hoping some authors more familiar than I with other tools can
> help with the latter task in particular.

Will it be easier if the text is in the wiki for people to contribute?



regards,
emma