No subject

Adeodato Simó dato at net.com.org.es
Fri Nov 30 22:46:02 GMT 2007


Hello Ian.

After packaging 1.0rc1 for Debian, I took a look at the provided
documentation to see what a user that just installs bzr would see.
Looks terrific, and I have just a couple small comments:

  - I think that the first link in index.html should not be the Quick
    Start Guide, since I think it's too bare for a first peek; that's
    just how I feel, though, it's okay if you think different. :)
    I'd personally place it after User Reference.

  - actually, the Quick Start Guide has the format (although it's not
    quite one) that of a reference card; I think changing its name to
    Reference Card would match the expectations of the user better,
    since I think "Quick Start *Guide*" calls for them to expect
    something more in the line of the 5 minutes tutorial.

  - I think it'd be nice if you could provide a png version of the svg
    as well, since there may be browsers where it doesn't get rendered
    very well (konqueror, for example)

Of these three items, I think the 2nd one is the most important, since
the usage of "Guide" there it's inconsistent with the rest of the
document, indeed.

Cheers,

-- 
Adeodato Simó                                     dato at net.com.org.es
Debian Developer                                  adeodato at debian.org
 
     Listening to: The Magnetic Fields - A Chicken With Its Head Cut Off




More information about the bazaar mailing list