Package: base-files
Version: 6.3
Severity: minor
Hi,
The topmost answer in the README file for base-files is very unwelcoming and
unfriendly to readers. As a user, I don't like to be spoken to at this tone
at all when I read a file that is actually *intended* to contain information
for users.
Let me quote:
> Frequently Asked Questions about base-files
> ===========================================
>
> * Questions about /etc/issue and /etc/debian_version:
>
> Q. I upgraded my system to the testing distribution and now my /etc/issue
> says "wheezy/sid". Should it not read "wheezy" or "testing"?
>
> Q. I upgraded my system to the unstable distribution and now my /etc/issue
> says "wheezy/sid". Should it not read "sid" or "unstable"?
>
> A. You obviously do not understand how the testing distribution works.
> [...]
My complaint is about the last line in the quote above. Instead of pointing
out how incredibly stupid the reader must be, the same message can be
reformulated in a much more friendly fasion. My suggestion is this:
"While this might seem strange, this is actually correct. To understand
this, you need to understand how the testing distribution works."
After all, this is a README file with FAQs intended to *help* people instead
of scaring them away.
Thanks for you consideration.
— Wouter (slightly offended)
-- System Information:
Debian Release: wheezy/sid
APT prefers testing
APT policy: (990, 'testing'), (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)
Kernel: Linux 2.6.38-2-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Versions of packages base-files depends on:
ii mawk [awk] 1.3.3-15 a pattern scanning and text proces
base-files recommends no packages.
base-files suggests no packages.
-- no debconf information
--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
