Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]
Groups > linux.debian.maint.python > #9935
| Path | csiph.com!fu-berlin.de!bofh.it!news.nic.it!robomod |
|---|---|
| From | Simon McVittie <smcv@debian.org> |
| Newsgroups | linux.debian.maint.python |
| Subject | Re: doc-central |
| Date | Fri, 13 Oct 2017 09:50:01 +0200 |
| Message-ID | <uA2Tf-Mw-1@gated-at.bofh.it> (permalink) |
| References | <uzTQ6-2RZ-201@gated-at.bofh.it> <uzUj3-3ov-91@gated-at.bofh.it> <uzUj3-3ov-89@gated-at.bofh.it> <uzVRL-4SH-5@gated-at.bofh.it> |
| 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 | <smcv@debian.org> |
| 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 | <debian-python@lists.debian.org> archive/latest/15317 |
| List-ID | <debian-python.lists.debian.org> |
| List-URL | <https://lists.debian.org/debian-python/> |
| 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> <ornbhc$t4h$1@blaine.gmane.org> <1507836421.2384.47.camel@ghic.org> <CAKTje6H2dH-jt=YjDTctO53pUc2+qeGuENYsX_ZsRWqQjGm3Jw@mail.gmail.com> |
| Xref | csiph.com linux.debian.maint.python:9935 |
Show key headers only | View raw
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
Back to linux.debian.maint.python | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread
doc-central Diane Trout <diane@ghic.org> - 2017-10-13 00:10 +0200
Re: doc-central Diane Trout <diane@ghic.org> - 2017-10-13 00:40 +0200
Re: doc-central Paul Wise <pabs@debian.org> - 2017-10-13 02:20 +0200
Re: doc-central Simon McVittie <smcv@debian.org> - 2017-10-13 09:50 +0200
Re: doc-central Diane Trout <diane@ghic.org> - 2017-10-13 19:40 +0200
Re: doc-central Stuart Prescott <stuart@debian.org> - 2017-10-13 01:10 +0200
csiph-web