[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Basic Bazaar guide for Emacs hackers.
From: |
Eli Zaretskii |
Subject: |
Re: Basic Bazaar guide for Emacs hackers. |
Date: |
Mon, 30 Nov 2009 21:27:45 +0200 |
> From: Karl Fogel <address@hidden>
> Date: Mon, 30 Nov 2009 00:03:59 -0600
> Cc: address@hidden
>
> Here's what I just did:
Thanks.
> Continued improvements to any of the docs welcome, of course.
I fixed one or two factual inaccuracies and slightly improved wording
in a couple of places.
What's below are random stylistic and methodological comments. Feel
free to do anything you want with them, including nothing at all.
. The page is biased towards contributors who don't have write access
to the Emacs repository. Notably, it gives almost all examples
using the HTPP URL, not the SFTP one. Sometimes it mentions the
SFTP method, sometimes it does not. It could be a better idea to
give both variants for each command.
. A Unix-like system is assumed without any notice to that effect.
Some commands will not work on Windows without subtle changes. For
example,
echo "public_branch = http://bzr.savannah.gnu.org/r/emacs/trunk" >>
.bzr/branch/branch.conf
will not do what you mean with the `echo' that it built into the
Windows shell. Maybe someone could add footnotes with Windows
equivalents, where applicable (in this case, either remove the
quotes or use the ported GNU `echo').
. The single-level sectioning is not the best one in this case,
because the page actually has 5 top-level sections, which I would
call Intro, Getting Started, One-Off Change, Feature Branch,
Resources; and some of these have sub-sections. Presenting them as
a single-level document makes it harder to grasp the outline of the
narrative. Suggest to have 2 levels of sections, not one.
. The "Overview of the Bazaar work routine" is too detailed, IMO, and
thus unnecessarily longish. We will be explaining all the details
in a moment, so I think only the main points should be left in this
overview.
. "Other Resources" should be at the beginning. Someone who looks
for a CVS-like way of doing things should not be required to read
through such a long document to find the alternatives near the end.
- Re: Basic Bazaar guide for Emacs hackers., (continued)
- Re: Basic Bazaar guide for Emacs hackers., Karl Fogel, 2009/11/29
- Re: Basic Bazaar guide for Emacs hackers., Lennart Borgman, 2009/11/29
- Re: Basic Bazaar guide for Emacs hackers., Óscar Fuentes, 2009/11/29
- Re: Basic Bazaar guide for Emacs hackers., Karl Fogel, 2009/11/29
- Re: Basic Bazaar guide for Emacs hackers., Stephen J. Turnbull, 2009/11/29
- Re: Basic Bazaar guide for Emacs hackers., Óscar Fuentes, 2009/11/30
- Re: Basic Bazaar guide for Emacs hackers., Karl Fogel, 2009/11/30
- Re: Basic Bazaar guide for Emacs hackers., Óscar Fuentes, 2009/11/30
- Re: Basic Bazaar guide for Emacs hackers., Stephen J. Turnbull, 2009/11/30
- Re: Basic Bazaar guide for Emacs hackers.,
Eli Zaretskii <=
- Re: Basic Bazaar guide for Emacs hackers., Karl Fogel, 2009/11/30
- Re: Basic Bazaar guide for Emacs hackers., Eli Zaretskii, 2009/11/30
- Re: Basic Bazaar guide for Emacs hackers., Karl Fogel, 2009/11/30
- Re: Basic Bazaar guide for Emacs hackers., Stephen J. Turnbull, 2009/11/30
- Re: Basic Bazaar guide for Emacs hackers., Richard Stallman, 2009/11/30
- Re: Basic Bazaar guide for Emacs hackers., Stephen J. Turnbull, 2009/11/30
- Re: Basic Bazaar guide for Emacs hackers., Óscar Fuentes, 2009/11/30
- Re: Basic Bazaar guide for Emacs hackers., Stephen J. Turnbull, 2009/11/30
- Re: Basic Bazaar guide for Emacs hackers., Karl Fogel, 2009/11/30
- Re: Basic Bazaar guide for Emacs hackers., Óscar Fuentes, 2009/11/30