Re: Please review the Debian Installer home page
Christian Perrier wrote:
> I would be grateful if you could review English in that file.
> <li>other images (netboot, usb stick, etc)<br />
s/usb/USB/g
> <li>For CD and DVD images, a <tt>MD5SUMS</tt> file is available in the
> same directory as the images.</li>
"an md5sums file".
> <li>The multi-arch <em>CD</em> images support i386/amd64/powerpc and
> alpha/hppa/ia64 respectively; the installation is similar to installing
> from a single architecture netinst image.</li>
"Respectively" is very rarely the right word in English; this is yet
another example of my rule of thumb that the English for
"respectively" is the empty string.
It would have worked if it said something like "The multi-arch
images MACD1 and MACD2 support i386/amd64/powerpc and
alpha/hppa/ia64 respectively" (it effectively just means "matched
off in that order"); but as given it just makes me want to try to
pair up i386 with alpha, amd64 with hppa...
> <li>Installation Guide:
> <a href="http://www.debian.org/releases/testing/installmanual">version for current beta release</a>
> —
> <a href="http://d-i.alioth.debian.org/manual/">development version</a><br />
> detailed installation instructions</li>
This is unclear (and possibly out of date). How about arranging it as:
* Installation Guide: [current release] and [development] versions
detailed installation instructions
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
--- index.wml.orig 2008-11-09 11:27:33.000000000 +0000
+++ index.wml 2008-11-09 11:54:22.000000000 +0000
@@ -51,7 +51,7 @@
<tr><td>DVD: </td><td><full-dvd-jigdo /></td></tr>
</table>
</li>
- <li>other images (netboot, usb stick, etc)<br />
+ <li>other images (netboot, USB stick, etc)<br />
<other-images />
</li>
</ul>
@@ -99,7 +99,7 @@
<li>multi-arch CD images<br />
<devel-multi-arch-cd />
</li>
- <li>other images (netboot, usb stick, floppy, etc)<br />
+ <li>other images (netboot, USB stick, floppy, etc)<br />
<devel-other-images />
</li>
</ul>
@@ -119,12 +119,12 @@
<ul>
<li>Before you download the daily built images, we suggest you check for
<a href="http://wiki.debian.org/DebianInstaller/Today">known issues</a>.</li>
- <li>For CD and DVD images, a <tt>MD5SUMS</tt> file is available in the
+ <li>For CD and DVD images, an <tt>md5sums</tt> file is available in the
same directory as the images.</li>
<li>For downloading full CD and DVD images the use of bittorrent or jigdo
is recommended.</li>
<li>The multi-arch <em>CD</em> images support i386/amd64/powerpc and
- alpha/hppa/ia64 respectively; the installation is similar to installing
+ alpha/hppa/ia64; the installation is similar to installing
from a single architecture netinst image.</li>
<li>The multi-arch <em>DVD</em> image supports i386/amd64/powerpc; the
installation is similar to installing from a single architecture full
@@ -150,9 +150,10 @@
<ul>
<li>Installation Guide:
- <a href="http://www.debian.org/releases/testing/installmanual">version for current beta release</a>
- —
- <a href="http://d-i.alioth.debian.org/manual/">development version</a><br />
+ <a href="http://www.debian.org/releases/testing/installmanual">current release</a>
+ and
+ <a href="http://d-i.alioth.debian.org/manual/">development</a>
+ versions<br />
detailed installation instructions</li>
<li><a href="http://wiki.debian.org/DebianInstaller/FAQ">Debian-Installer FAQ</a>
and <a href="$(HOME)/CD/faq/">Debian-CD FAQ</a><br />
#use wml::debian::template title="Debian-Installer" NOHEADER="true"
#use wml::debian::recent_list
#include "$(ENGLISHDIR)/releases/info"
#include "$(ENGLISHDIR)/devel/debian-installer/images.data"
<h1>News</h1>
<p><:= get_recent_list('News/$(CUR_YEAR)', '2',
'$(ENGLISHDIR)/devel/debian-installer', '', '\d+\w*' ) :>
<a href="News">Older news</a>
</p>
<h1>Installing with the Debian-Installer</h1>
<if-stable-release release="etch">
<p>
<strong>For official Debian <current_release_etch> installation media and
information</strong>, see
<a href="$(HOME)/releases/etch/debian-installer">the etch page</a>.
</p>
</if-stable-release>
<p>
<strong>To install Debian testing</strong>, we recommend you use
the <strong>lenny RC1 release</strong> of the installer, after checking its
<a href="errata">errata</a>. The following images are available for
lenny RC1:
</p>
<ul>
<li>netinst (generally 135-175 MB) CD images<br />
<netinst-images />
</li>
<li>businesscard (generally 20-50 MB) CD images<br />
<businesscard-images />
</li>
<li>full CD/DVD sets<br />
<table cellpadding="0" cellspacing="0">
<tr><td>CD: </td><td><full-cd-images /></td></tr>
<tr><td>DVD: </td><td><full-dvd-images /></td></tr>
</table>
</li>
<li>full CD/DVD sets (via <a href="$(HOME)/CD/torrent-cd">bittorrent</a>)
<table cellpadding="0" cellspacing="0">
<tr><td>CD: </td><td><full-cd-torrent /></td></tr>
<tr><td>DVD: </td><td><full-dvd-torrent /></td></tr>
</table>
</li>
<li>full CD/DVD sets (via <a href="$(HOME)/CD/jigdo-cd">jigdo</a>)
<table cellpadding="0" cellspacing="0">
<tr><td>CD: </td><td><full-cd-jigdo /></td></tr>
<tr><td>DVD: </td><td><full-dvd-jigdo /></td></tr>
</table>
</li>
<li>other images (netboot, USB stick, etc)<br />
<other-images />
</li>
</ul>
<p>
Or install the <b>current weekly snapshot of Debian testing</b>
which uses the same version of the installer as the last release:
</p>
<ul>
<li>full CD/DVD sets<br />
<table cellpadding="0" cellspacing="0">
<tr><td>CD: </td><td><devel-full-cd-images /></td></tr>
<tr><td>DVD: </td><td><devel-full-dvd-images /></td></tr>
</table>
</li>
<li>full CD/DVD sets (via <a href="$(HOME)/CD/torrent-cd">bittorrent</a>)
— only sufficiently seeded images are listed
<table cellpadding="0" cellspacing="0">
<tr><td>CD: </td><td><devel-full-cd-torrent /></td></tr>
# Not really enough time to get these seeded properly
# <tr><td>DVD: </td><td><devel-full-dvd-torrent /></td></tr>
</table>
</li>
<li>full CD/DVD sets (via <a href="$(HOME)/CD/jigdo-cd">jigdo</a>)
<table cellpadding="0" cellspacing="0">
<tr><td>CD: </td><td><devel-full-cd-jigdo /></td></tr>
<tr><td>DVD: </td><td><devel-full-dvd-jigdo /></td></tr>
</table>
</li>
</ul>
<p>
If you'd like something newer to help us test a future release of the
installer, or because of hardware problems or other issues, try one of these
<strong>daily built images</strong> which contain the latest available version of
installer components.
</p>
<ul>
<li>netinst (generally 135-175 MB) and businesscard (generally 20-50 MB) CD images<br />
<devel-small-cd-images />
</li>
<li>netinst and businesscard CD images (via <a href="$(HOME)/CD/jigdo-cd">jigdo</a>)<br />
<devel-small-cd-jigdo />
</li>
<li>multi-arch CD images<br />
<devel-multi-arch-cd />
</li>
<li>other images (netboot, USB stick, floppy, etc)<br />
<devel-other-images />
</li>
</ul>
<p>
If any of the hardware in your system <strong>requires firmware to be
loaded</strong> with the device driver, you can use one of the
<a href="http://cdimage.debian.org/cdimage/unofficial/non-free/firmware/">\
tarballs of common firmware packages</a>. Instructions how to use the tarballs
and general information about loading firmware during an installation can
be found in the <a href="http://www.debian.org/releases/testing/installmanual">Installation Guide</a>.
</p>
<p>
<strong>Notes</strong>
</p>
<ul>
<li>Before you download the daily built images, we suggest you check for
<a href="http://wiki.debian.org/DebianInstaller/Today">known issues</a>.</li>
<li>For CD and DVD images, an <tt>md5sums</tt> file is available in the
same directory as the images.</li>
<li>For downloading full CD and DVD images the use of bittorrent or jigdo
is recommended.</li>
<li>The multi-arch <em>CD</em> images support i386/amd64/powerpc and
alpha/hppa/ia64; the installation is similar to installing
from a single architecture netinst image.</li>
<li>The multi-arch <em>DVD</em> image supports i386/amd64/powerpc; the
installation is similar to installing from a single architecture full
CD image; the DVD also includes the source for all included packages.</li>
<li>As m68k is currently not included in the <q>testing</q> suite, there
are no weekly snapshots for m68k.</li>
</ul>
<p>
<strong>After using the Debian-Installer</strong>, please send us an
<a href="http://d-i.alioth.debian.org/manual/en.i386/ch05s03.html#submit-bug">installation report</a>,
even if there weren't any problems.
</p>
<h1>Documentation</h1>
<p>
<strong>If you read only one document</strong> before installing, read our
<a href="http://d-i.alioth.debian.org/manual/en.i386/apa.html">Installation
Howto</a>, a quick walkthrough of the installation process. Other useful
documentation includes:
</p>
<ul>
<li>Installation Guide:
<a href="http://www.debian.org/releases/testing/installmanual">current release</a>
and
<a href="http://d-i.alioth.debian.org/manual/">development</a>
versions<br />
detailed installation instructions</li>
<li><a href="http://wiki.debian.org/DebianInstaller/FAQ">Debian-Installer FAQ</a>
and <a href="$(HOME)/CD/faq/">Debian-CD FAQ</a><br />
common questions and answers</li>
<li><a href="http://wiki.debian.org/DebianInstaller">Debian-Installer Wiki</a><br />
community maintained documentation</li>
</ul>
<h1>Contacting us</h1>
<p>
The <a href="http://lists.debian.org/debian-boot/">debian-boot
mailing list</a> is the main forum for discussion and work on
Debian-Installer.
</p>
<p>
We also have an IRC channel, #debian-boot on <tt>irc.debian.org</tt>. This
channel is used mainly for development, but occasionally for support.
If you do not receive a response, try the mailing list instead.
</p>
Reply to: