[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: log format for vc-bzr

From: Miles Bader
Subject: Re: log format for vc-bzr
Date: Sat, 09 Jan 2010 04:41:29 +0900

Eli Zaretskii <address@hidden> writes:
> It is this wrong POV that is one of the reasons that the current bzr
> docs impose such a tremendous mental pressure on a novice who is
> trying to make themselves fluent with the tool.

The "novice" is going to fail unless he has _some_ mental model of how
things work, and that mental model had better be something reasonably
close to how the actual tool works.

Dumbing-down documentation beyond a certain point simply leaves you with
useless documentation, not enlightened users...


Ich bin ein Virus. Mach' mit und kopiere mich in Deine .signature.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]