Package: debian-cd
Version: N/A; reported 2006-12-22
Priority: wishlist
I would really like to have debian-cd generate a 'documentation media' (DVD
or CD) which could be used to read documentation without having to install
the system. That documentation media would contain *both* the english and
available translations of, at least:
- The Release Notes
- The Installation Guide
- The Refence Guide
- The User Guide
- The Project History
- The FAQ
- The Securing Debian Manual
- The Reference Card
- The Quick Reference
- The APT Howto
Content could be extracted (in an automatic way) from both the website [1]
and/or from the Debian packages providing them [2].
Unfortunately, the ftp site (as used in the 'add-bin-doc' script) is not an
option because #172482 has not been considered and, consequently, the 'doc'
directory in the mirrors do not contain translations or DDP manuals which are
not provided (yet) in Debian packages.
Also, there are all the issues around 'byhand' processing. See, for example
where is doc-debian 3.1.4 (has been sitting in incoming for
byhand processing for a month).
By providing all that content in easily printable format it would make it
easier for users that do not have good broadband access and have not yet
installed Debian to go through or print those manuals before even starting
installation.
This could also fix the issue that, in past releases, official CD images have
_not_ provide content useful for non-English speakers in the /doc directory
(look at, for example, the FAQ)
Having all that content in one place makes it more easier for users to find
and take profit of (you'll see below that the document to package mapping is
not at all evident for a novice user).
Just my wishlist :)
Javier
[1] Some of these are available under http://www.debian.org/doc/manuals/, or, more
precisely, from /org/www.debian.org/www/doc/manuals , and the
release-specific info is at http://www.debian.org/releases/etch/
(/org/www.debian.org/www/releases/etch)
The Reference Card is at http://people.debian.org/~debacle/refcard/
[2] By extracing all of /usr/share/doc/${package} to the CD.
The FAQ = doc-debian
The Installation Guide = installation-guide-XXX
The Refence Guide = debian-reference-XX
The Quick Refence = quick-reference-XX
The Project History =
The APT HOWTO = apt-howto-XX
The Securing Debian Manual = harden-doc
Attachment:
signature.asc
Description: Digital signature