Received: (at submit) by bugs.debian.org; 20 Aug 2001 22:21:52 +0000 From adam@onshore.com Mon Aug 20 17:21:52 2001 Return-path: Received: from arroz.onshored.com [216.220.101.2] (postfix) by master.debian.org with esmtp (Exim 3.12 1 (Debian)) id 15YxQe-0000hW-00; Mon, 20 Aug 2001 17:21:52 -0500 Received: from arroz.onshored.com (localhost [127.0.0.1]) by arroz.onshored.com (Postfix) with ESMTP id 0FE6193820 for ; Mon, 20 Aug 2001 18:22:17 -0400 (EDT) Sender: adam@arroz.onshored.com To: submit@bugs.debian.org Subject: [Yoshito Komatsu ] Re: "Section" in *.doc-base file. Organization: onShore Development, Inc From: Adam Di Carlo Date: 20 Aug 2001 18:22:16 -0400 Message-ID: Lines: 119 User-Agent: Gnus/5.0808 (Gnus v5.8.8) Emacs/20.7 MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Delivered-To: submit@bugs.debian.org --=-=-= Package: doc-base From: Yoshito Komatsu Hello. Thank you for replying. On Fri, Aug 17, 2001 at 10:26:53AM -0400, Adam Di Carlo wrote: > > I started discussing about sections in doc-base > > at debian-devel@lists.debian.org. > > > > Could you join us? > > No -- I'm not on that list and it's too high-volume for me. > > Please email me a summary of the discussion. Feel free to CC me on > any emails about this, even on the list. There are two idea about doc-base sections. At present, most of *.doc-base files in my PC seems to be located in sections according to menu-policy. "We should make doc-base policy keeping the present state", this is one idea. Following this idea, sections will be as follows. // Debian doc-base policy Apps/ Desctiption: Apps/ is a section for applications' documents. All applications are filed according to its functionality. (e.g. AbiWord under Apps/Editors, GIMP under Apps/Graphics, GNotes! under Apps/Editors, Modem Lights applet under Apps/Net) Subsections: Databeses Editors Emulators Graphics Hamradio Math Net Programming Tools Technical Text Shells Multimedia Viewers System Games Help Debian/ Description: Debian/ is a section for specific documents of Debian. (e.g. Debian Policy Manual, Debian Developer's Reference) Devel/ Description: Devel/ is a section for development. (e.g. GTK+ Reference, HTML Reference, C Language Reference) Documents for programming "application"(including IDEs, unix-like tools for programming) are included in Apps/Programming section. Licenses/ Description: Licenses/ is a section for licences. (e.g. GNU General Public License, GNU Free Documentation License) // Debian doc-base policy But, some people think it's a mistake to make "Apps" a category and we should think separately from menu-policy because they think menu-policy isn't suitable to search for documentation. They make another draft, this is another idea. Following this idea, sections will be as follows. // Debian doc-base policy Databases Debian Editors Emulators Games Graphics Licenses Mathematics Multimedia Networking Programming Radio Science Shells System Administration Text Viewers // Debian doc-base policy Which idea shoud we take? For more information, please see a series of messages started from "http://lists.debian.org/debian-devel/2001/debian-devel-200108/msg00869.html". Regards, -- Yoshito Komatsu GPG key fingerprint: 4E0C 2629 6DC7 5EA7 3957 8982 2156 1D44 D12C 489D --=-=-= -- ...Adam Di Carlo..... --=-=-=--