Path: csiph.com!fu-berlin.de!bofh.it!news.nic.it!robomod From: Simon McVittie Newsgroups: linux.debian.maint.python Subject: Re: doc-central Date: Fri, 13 Oct 2017 09:50:01 +0200 Message-ID: References: X-Original-To: debian-python@lists.debian.org X-Mailbox-Line: From debian-python-request@lists.debian.org Fri Oct 13 07:42:00 2017 Old-Return-Path: X-Amavis-Spam-Status: No, score=-4.9 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, FOURLA=0.1, LDO_WHITELIST=-5, ONEWORD=2] autolearn=no autolearn_force=no X-Policyd-Weight: using cached result; rate: -5 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: NeoMutt/20170609 (1.8.3) X-Mailing-List: archive/latest/15317 List-ID: List-URL: List-Archive: https://lists.debian.org/msgid-search/20171013074141.4wte73d452lrubmy@perpetual.pseudorandom.co.uk Approved: robomod@news.nic.it Lines: 26 Organization: linux.* mail to news gateway Sender: robomod@news.nic.it X-Original-Date: Fri, 13 Oct 2017 08:41:41 +0100 X-Original-Message-ID: <20171013074141.4wte73d452lrubmy@perpetual.pseudorandom.co.uk> X-Original-References: <1507762241.19151.22.camel@ghic.org> <1507836421.2384.47.camel@ghic.org> Xref: csiph.com linux.debian.maint.python:9935 On Fri, 13 Oct 2017 at 08:13:08 +0800, Paul Wise wrote: > On Fri, Oct 13, 2017 at 3:27 AM, Diane Trout wrote: > > > Being able to find all your documentation in one place would really be > > convenient. > > I don't think doc-base/doc-central will ever be the answer to this as > it is very specific to Debian and thus not available on other distros. > Eventually the Freedesktop folks will come up with something > cross-distro and cross-desktop and we will have to replace doc-base > with it, just like we had to do with the Debian-specific menu system. ... unless someone from Debian with an interest in documentation goes upstream and comes up with something cross-distro, cross-desktop and suspiciously similar to doc-base. Relevant people to talk to would include the maintainers of GNOME's yelp (user-facing, usually-topic-based help in Docbook or Mallard format, processed into HTML for viewing) and devhelp (developer reference documentation in any format, processed into HTML at build-time), and their equivalents in other upstream projects. As far as I understand it, yelp and devhelp are separate apps as a deliberate design choice, because they have different audiences and requirements. Whether you agree with it or not, understanding the reasoning behind that design choice seems likely to be valuable. smcv