Bug#674607: debian-handbook: improvements for the fourth chapter

2012-06-01 Thread Raphael Hertzog
clone 674607 -1
severity -1 wishlist
retitle -1 Document multi-arch and review 32/64 bits recommendation in light of 
this
tag -1 wheezy
thanks

On Fri, 25 May 2012, Francesco Poli (wintermute) wrote:
 Section 4.2.1. Booting and Starting the Installer
 -
 
 | In practice, the 64 bit version is only relevant on a server rather than
 | a desktop workstation, since it will cause difficulties with the use of
 | certain non-free software that are released only as binaries.
 
 I think this sentence is too strong.
 I mean: claiming that the amd64 version is irrelevant for desktop
 workstations, just because some non-free programs are not available
 for this architecture, seems to over-estimate the importance of those
 proprietary programs.

I will keep it like this for now. But for the wheezy edition, I will
revisit this in light of the availability of multi-arch.

 Section 4.2.13. Starting the Partitioning Tool
 --
 
 | has an guided mode
 
 Typo?   s/an guided/a guided/

Was already fixed in Git.

 Section 4.2.13.1. Guided partitioning
 -
 
 | server software data (/var/,
 
 Missing closing parenthesis after /var/ ?

Fixed, thank you.

 Section 4.2.15. Configuring the Package Manager (apt)
 -
 
 | (a mirror is a public server hosting copies of all the files of
 | the Debian server)
 
 I feel that Debian server is not especially clear.
 Maybe   s/Debian server/Debian master archive/   ?

Done.

Cheers,
-- 
Raphaël Hertzog ◈ Debian Developer

Get the Debian Administrator's Handbook:
→ http://debian-handbook.info/get/



--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org



Bug#674607: debian-handbook: improvements for the fourth chapter

2012-05-25 Thread Francesco Poli (wintermute)
Package: debian-handbook
Version: 6.0+20120509
Severity: minor

Hi Raphaël,
I've just finished reading chapter 4.
What follows is the list of improvements and corrections I propose
for this chapter, again grouped by relevant section.


Section 4.2.1. Booting and Starting the Installer
-

| In practice, the 64 bit version is only relevant on a server rather than
| a desktop workstation, since it will cause difficulties with the use of
| certain non-free software that are released only as binaries.

I think this sentence is too strong.
I mean: claiming that the amd64 version is irrelevant for desktop
workstations, just because some non-free programs are not available
for this architecture, seems to over-estimate the importance of those
proprietary programs.

I acknowledge that some people seem to consider those programs as
essential, but not all users think the same!

Implicitly saying that a desktop workstation is useless without those
non-free programs indirectly promotes proprietary software: I believe
that debian-handbook should *not* do that!

I would drop the above-quoted sentence entirely, since the same
reasoning is anyway included in the Going further box immediately
below.


| It is technically possible to make them work on 64 bit systems,

For the reasons outlined above, I would add

+ If you really need those proprietary programs, it is technically possible
+ to make them work on 64 bit systems,


| If you already have a working Windows system, you can even do without the
| recovery CD-ROM;

I am not sure this sentence should talk about recovery.
Maybe   s/recovery CD-ROM/installation CD-ROM/   ?


Section 4.2.13. Starting the Partitioning Tool
--

| has an guided mode

Typo?   s/an guided/a guided/


Section 4.2.13.1. Guided partitioning
-

| server software data (/var/,

Missing closing parenthesis after /var/ ?


Section 4.2.15. Configuring the Package Manager (apt)
-

| (a mirror is a public server hosting copies of all the files of
| the Debian server)

I feel that Debian server is not especially clear.
Maybe   s/Debian server/Debian master archive/   ?



--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org