1. Forum
  2. Usenet
  3. LINUX.DEBIAN.WWW

  • Bug#871659: www.debian.org: scripts: Debian GNU/Linux FAQ should not be

    From Joost van =?UTF-8?Q?Baal-Ili=C4=87?@21:1/5 to All on Fri Aug 11 19:10:02 2017
    XPost: linux.debian.bugs.dist

    Hi Javier,

    Do you agree the FAQ could better be typesetted from the .deb? Or am I missing something here? (I've had a chat with David Prévot about this bug, he mentioned you were involved in setting this all up and had some insight in it.)

    Bye,

    Joost

    PS/Note to self: involved scripts:
    git/debwww/cron/parts/7doc
    git/debwww/cron/parts/7doc_manuals
    svn/debian/manuals/trunk/Makefile

    On Thu, Aug 10, 2017 at 03:47:13PM +0200, Joost van Baal-Ilić wrote:
    Package: www.debian.org
    Severity: normal

    Hi,

    Previous, in https://lists.debian.org/msgid-search/20170806213642.GA17680@beskar.mdcc.cx :

    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.)

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)