Re: BK kernel workflow

[Larry McVoy <lm@bitmover.com>]

On Tue, Oct 26, 2004 at 02:16:22PM -0400, Ryan Anderson wrote:
> On Tue, Oct 26, 2004 at 07:23:21AM -0700, Larry McVoy wrote:
> > That's because you didn't read the documentation which you appear to love 
> > so much.
> 
> Well, Larry, to be perfectly honest - the documentation is ... terse, at
> the moment.

Yes, we know.  On the other hand, we're probably pushing 60,000 users or
so who have figured it out by tinkering with the tool.  There is no 
question that there needs to be a BitKeeper book or at least a much more
expanded and updated userguide.

> Yes, I know, documentation isn't fun - it probably needs an editor to
> go over it and say, "What assumptions should we make about the knowledge
> a user has?" and then try really hard to keep that list *short* and
> strictly adhered to in all the pages.

Yup.  We have an open req for a docs person, if you know someone who
wants a fulltime job in the Bay Area or an incredibly exceptional remote
person we're very interested (and I'll shut up about that, I'm not trying
to use the list for free job advertising, just don't want to create the
impression that we don't recognize the issues).

> Oh, and I *do* play a paying customer at my day job.  Just some days I
> wish the documentation was a little more helpful.  (Specifically, you
> desperately need more examples of triggers.)

Well if you are paying your support includes that sort of help.  Call
us up and ask for examples or send mail to support and ask for help.
Even if you aren't paying you can always ask, if we can we help people
out promptly.
-- 
---
Larry McVoy                lm at bitmover.com           http://www.bitkeeper.com