Bug#871659: www.debian.org: scripts: Debian GNU/Linux FAQ should not be typesetted on webserver but webserver should use faq .deb (was: Re: [...] Debian Documentation BoF @ DebConf17 [...])

Joost van Baal-Ilić <[email protected]> Thu, 10 Aug 2017 15:47:13 +0200

Newsgroups	gmane.linux.debian.devel.www
Message-ID	<20170810134713.GR11325__28602.0460808233$1502373445$gmane$org@beskar.mdcc.cx>

Package: www.debian.org
Severity: normal

Hi,

Previous, in
https://lists.debian.org/msgid-search/[email protected] :

On Mon, Aug 07, 2017 at 11:06:54PM +0200, Joost van Baal-Ilić wrote:
> On Sun, Aug 06, 2017 at 11:36:42PM +0200, Joost van Baal-Ilić wrote:
> > On Sat, Aug 05, 2017 at 06:38:51PM +0200, Joost van Baal-Ilić wrote:
> > > On Fri, Aug 04, 2017 at 01:06:40PM +0200, Joost van Baal-Ilić wrote:
<snip>
> > > >  We'll be discussing the state of Debian's Documentation, what we would
> > > >  like it to be (the Arch wiki?), and how to get there.
> > <snip> 
> > The BoF was not video-d
<snip>
> > Here's the "slides", and, more importantly, some notes/conclusions reached.
> > 
> >           Debian Documentation BoF
> >                     by
> >         you and Joost van Baal-Ilić
<snip>
> >       DebConf17, Montréal, august 2017
<snip>
> > Notes taken during the discussion
> > - faq should not be typesetted at webserver; website should use .deb of faq
<snip>

The Debian GNU/Linux FAQ, as publised at
https://www.debian.org/doc/manuals/debian-faq/ , is one of the very few of our
documents which gets fetched from VC and build/typesetted by the webserver;
most other documents use the content as shipped by the document's .deb
packages.  The latter scheme is better since it saves resource usage on our
webserver.  We loose frequent updates of the web-published content.  However,
the source content of our documents is no longer updated very frequently
anyway, so I feel we're ready for using the .deb.

I plan to fix this bug myself.  Note to self: hack on
ssh://git.debian.org/git/debwww/cron.git (Thanks Osamu Aoki.)

Bye,

Joost

signature.asc (application/pgp-signature, 819 B)