Refreshing the Bazaar docs for 2.0
Philippe Lhoste
PhiLho at GMX.net
Wed Jul 22 17:23:22 BST 2009
On 22/07/2009 17:38, Ian Clatworthy wrote:
> To get the ball rolling, here's the proposed new presentation:
> http://people.canonical.com/~ianc//bzr2-docs/
Nice.
I have suggested some improvements (for add/ignore in User Reference)
recently, I don't know if they were noticed or valuable enough to be
taken in account...
The double ToC in the reference is strange, but probably a quick
refactoring avatar.
I like the new CSS, lightweight, not in the way, readable.
The User Guide: I /don't/ like the "break everything in tiny pages". Too
much to click through (and not even quick navigation jumps yet), it
makes impossible to print the doc, it looks too much like those sites
breaking articles in tiny chunks to give more exposure to the ads!
I prefer the big unique page, although I can understand it might seem
overwhelming (but it is nice to jump around and search stuff).
I can live with a medium break down, eg. one page per chapter (Personal
version control, Sharing with peers, etc.).
Or just generate the three versions, if these pages are made with a tool
with a generic source.
--
Philippe Lhoste
-- (near) Paris -- France
-- http://Phi.Lho.free.fr
-- -- -- -- -- -- -- -- -- -- -- -- -- --
More information about the bazaar
mailing list