[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#721215: The Debian Administration Handbook and https://www.debian.org/doc


El 10/06/15 a las 06:45, Joost van Baal-Ilić escribió:
> Hi,
> I can't find any "Debian Administrator's Manual" which is DFSG-free and
> packaged in Debian; as mentioned by original bug submitter.
> (I _did_ find the "Debian GNU/Linux System Administrator's Manual" (obsolete,
> Copyright © 1997 Ardo van Rangelrooij Copyright © 1998 Oliver Elphick Copyright
> © 1998 Tapio Lehtonen); there's an old copy still at
> http://debian.man.ac.uk/non-debian/LDP/LDP/www.debian.org/doc/manuals/system-administrator
> .)
> Indeed, it seems we're talking about "The Debian Administration Handbook".  I
> agree with the bug's submitter that that one needs a more prominent place under
> http://www.debian.org/doc .  An entry under "Users' manuals", and an entry on
> https://www.debian.org/doc/user-manuals (which could be renamed from "DDP
> Users' Manuals" to "Users' Manuals") would be appropriate, imho.

Is it important to state whether a piece of documentation belongs to the
Debian Documentation Project or not? I think yes (I'm not part of DDP,
though...), and I think it's better to create a new section than
removing the "DDP" part of the title in "user-manuals" and add the
handbook there.

Any other opinion?

> https://www.debian.org/doc/books could refer to the new
> https://www.debian.org/doc/user-manuals#debian-handbook .

I would update the entry of books, to reference the page/section where
we finally add the Handbook.


> Bye,
> Joost
> On Wed, Jun 10, 2015 at 01:29:57AM +0200, Laura Arjona Reina wrote:
>> Hi everybody
>> If you refer to "The Debian Administration Handbook" (the first
>> reference listed in the subpage https://www.debian.org/doc/books), I
>> have no clear idea about what to do.
>> On one side, the reference should stay there even if we add an entry in
>> "user manuals", because it's a printed book.
>> On the other side, I'm not sure if "user manuals" is for the
>> documentation maintained by the Debian Documentation Project (and then,
>> the Handbook shouldn't be there, even if there is a package available,
>> several translations, and it's DFSG-free).
>> Finally, I suppose we could change the title of the section "Other,
>> shorter documents" to "Other, and shorter documents" and include a link
>> as first reference in that section, but I think it's not a good solution.
>> CC'ing debian-doc mailing list, I hope they can give advice about how to
>> proceed.
>> Regards
>> -- 
>> Laura Arjona
>> https://wiki.debian.org/LauraArjona

Laura Arjona

Reply to: