Doc review & quick ref card - anyone with some DTP skills?
jyates at netezza.com
Fri Jul 27 14:36:42 BST 2007
Ian Clatworthy wrote:
> > John Yates wrote:
> > Which is why this is not a "Quick Reference". It would be much
> > more correctly termed a "Quick Start Guide".
> IMO, it's *a* Quick Reference, just not *the* Quick Reference. Maybe we
> should rename it "Bazaar Essentials Quick Reference" or something like
On the wiki this document is now advertised as a "one page summary of
Bazaar". It is nothing of the sort.
In 35 years in engineering I have never encountered a document titled
a Reference that did not attempt to be complete and authoritative. The
current document probably has a role but it is tutorial, not reference.
Here is an svn example of a "one-pager" (assuming you have a duplexing
printer) that can legitimately purport to be a reference document:
Our document is an introduction, a summary, a "for dummies", ... nearly
anything but a reference.
More information about the bazaar