[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...
-Miles
--
Ich bin ein Virus. Mach' mit und kopiere mich in Deine .signature.
- bzr Q&A [was Re: log format for vc-bzr], (continued)
- bzr Q&A [was Re: log format for vc-bzr], Stephen J. Turnbull, 2010/01/09
- Re: log format for vc-bzr, Stephen J. Turnbull, 2010/01/08
- Re: log format for vc-bzr, Eli Zaretskii, 2010/01/08
- Re: log format for vc-bzr, Juanma Barranquero, 2010/01/08
- Re: log format for vc-bzr, Stephen J. Turnbull, 2010/01/08
- Re: log format for vc-bzr, Eli Zaretskii, 2010/01/09
- Re: log format for vc-bzr, Óscar Fuentes, 2010/01/08
- Re: log format for vc-bzr, Eli Zaretskii, 2010/01/08
- Re: log format for vc-bzr, Óscar Fuentes, 2010/01/08
- Re: log format for vc-bzr, Eli Zaretskii, 2010/01/08
- Re: log format for vc-bzr,
Miles Bader <=
- Re: log format for vc-bzr, Eli Zaretskii, 2010/01/08
- Re: log format for vc-bzr, Óscar Fuentes, 2010/01/08
- Re: log format for vc-bzr, Eli Zaretskii, 2010/01/08
- Re: log format for vc-bzr, Óscar Fuentes, 2010/01/08
- Re: log format for vc-bzr, Eli Zaretskii, 2010/01/08
- Re: log format for vc-bzr, Óscar Fuentes, 2010/01/08
- Re: log format for vc-bzr, Thien-Thi Nguyen, 2010/01/09
- Re: log format for vc-bzr, Andreas Schwab, 2010/01/09
- Re: log format for vc-bzr, Thien-Thi Nguyen, 2010/01/09
- Re: log format for vc-bzr, Miles Bader, 2010/01/08