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

Laura Arjona Reina <[email protected]>
Newsgroups gmane.linux.debian.devel.www
Message-ID <55781F37.1070601__21887.2192352594$1433935838$gmane$org@larjona.net>
Hi

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.

Thanks


> 
> 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
https://wiki.debian.org/LauraArjona
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.