|
|
Hiya,
I've just gone through the release notes for a general review and
especially to review all the recent commits by Andreas.
BTW: many thanks for processing all the open BRs!
Attached a patch with proposed spelling/gramatical fixes. Please check.
Below a number of suggestions for changes.
- Rename chapter 1 from "What's new in the Release Notes" to
"Introduction". After all, there is very little actual news about the
release notes in that (short) chapter.
I feel that the changelog for post-release changes still fits under
that heading.
- 2.1.1 debian-volatile now an official service
I see that volatile.d.o is still not up. What is the status for that?
- 2.2 What's new in the installation system?
Next on my TODO list.
- 4.4.2 Upgrading aptitude
I propose to drop this section. Bill Allombert has shown [1] that
upgrading aptitude on its own can lead to a number of removals due
to the C++ transition.
Steinar has stated that Etch's aptitude is much better at dependency
resolution though [2]. I've asked him to elaborate.
- 4.4.5 Possible issues during upgrade
"Please check also in Issues to be aware of for etch, Chapter 5 about
issues explicitly listed there."
I don't feel that this comment should be included in this section.
Moving it to "4.1 Preparing for the upgrade" seems more logical to me.
- 4.5 Upgrading your kernel and related packages
- There is no explanation _why_ the kernel should be upgraded
separately.
- My feeling is that this section is currently very messy. It contains
some info that is general in nature and belongs in Chapter 2 instead,
along with some info (e.g. devfs) that should be mentioned much
earlier in chapter 4 as it needs to be done _before_ starting the
actual upgrade. There are also some issues that belong more in
chapter 5 (device numeration).
- Also, the current text will leave any user in confusion as to what he
should actually do: upgrade the kernel first and reboot before
upgrading the reset of the system; just upgrade the meta package as
part of the main upgrade (which is implied in "4.5.6 upgrading the
kernel", but totally contradicts "4.5 Upgrading your kernel and
related packages".
- The command
# apt-cache search linux-image-2.6- | grep -v transition
will also list vserver and xen kernels, which may confuse users.
The added support of vserver and xen should probably be mentioned
in chapter 2.
If you agree with these general points I'll try to come up with a
patch to improve things.
- 5.1.1 Certain networking site cannot be reached by TCP
This heading is not correct English. At least it needs s/site/sites/,
but I have some doubts if the term "networking sites" is correct at
all.
- 5.1.3 Apt downloads small files with update
I feel this is not so much an "issue" as a "change in the distribution"
and should therefore be mentioned in chapter 2 instead of here.
- 5.4 Upgrading from exim 3 to exim4
The use of 'exim 3' and exim4 seems inconsistent. I'd suggest using
plain 'exim' in the heading and 'exim (version 3.xx)' in the main text.
[1] http://lists.debian.org/debian-release/2006/11/msg00345.html
[2] http://lists.debian.org/debian-release/2006/11/msg00206.html
release-notes.patch
Description: Text Data
|
|