Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.debian.project > #12480

Re: Bug#273323: doc-debian: please ship typesettable version of social contract and dfsg documents

From Diederik de Haas <didi.debian@cknow.org>
Newsgroups linux.debian.project, linux.debian.bugs.dist
Subject Re: Bug#273323: doc-debian: please ship typesettable version of social contract and dfsg documents
Date 2021-09-08 15:20 +0200
Message-ID <CV4Sd-1Zq-1@gated-at.bofh.it> (permalink)
References <CUu2l-3wG-11@gated-at.bofh.it> <CUIoH-4go-11@gated-at.bofh.it> <CV0bT-7p1-1@gated-at.bofh.it>
Organization Connecting Knowledge

Cross-posted to 2 groups.

Show all headers | View raw


[Multipart message — attachments visible in raw view] - view raw

On woensdag 8 september 2021 09:22:11 CEST Gard Spreemann wrote:
> there should perhaps be an authoritative version of the text,
> from which PDF, whatever-printable, HTML, etc. can be generated

I think that's a good idea.
But then the question becomes: what is the authoritative version?

I get the impression that https://www.debian.org/social_contract 
is (often?) seen as *the* version. But that page is generated from 
https://salsa.debian.org/webmaster-team/webwml/-/blob/master/english/social_contract.wml

The homepage for wml according to the wml package is 
https://www.shlomifish.org/open-source/projects/website-meta-language/

which mentions "which is an old offline preprocessor for HTML 
and XHTML which is sophisticated but quirky and slow" and 
the linked GitHub repo has the following in its about section:

"An old offline HTML preprocessor (which can be used for static 
site generation), written in Perl and C that is still maintained for 
legacy reasons, but probably not recommended for new sites."

Given that, is it wise to have the WML version as the 
authoritative one?

Pandoc supports various input formats, but I didn't see WML.
It does support DocBook and Joost did provide a patch which
contains a DocBook version of the Social Contract
(converted from the WML version btw)

OTOH, it feels like I'm WAY overthinking this ;-P

Cheers,
  Diederik

Back to linux.debian.project | Previous | NextPrevious in thread | Next in thread | Find similar | Unroll thread


Thread

Bug#273323: doc-debian: please ship typesettable version of social contract and dfsg documents Diederik de Haas <didi.debian@cknow.org> - 2021-09-06 23:10 +0200
  Bug#273323: doc-debian: please ship typesettable version of social contract and dfsg documents Gard Spreemann <gspr@nonempty.org> - 2021-09-07 11:40 +0200
    Bug#273323: doc-debian: please ship typesettable version of social contract and dfsg documents Diederik de Haas <didi.debian@cknow.org> - 2021-09-07 14:30 +0200
      Re: Bug#273323: scripting solution Daniel Lange <DLange@debian.org> - 2021-09-08 07:50 +0200
      Bug#273323: doc-debian: please ship typesettable version of social contract and dfsg documents Gard Spreemann <gspr@nonempty.org> - 2021-09-08 09:30 +0200
        Re: Bug#273323: doc-debian: please ship typesettable version of social contract and dfsg documents Diederik de Haas <didi.debian@cknow.org> - 2021-09-08 15:20 +0200
          Re: Bug#273323: doc-debian: please ship typesettable version of social contract and dfsg documents Paul Wise <pabs@debian.org> - 2021-09-09 06:10 +0200
            Bug#273323: doc-debian: please ship typesettable version of social contract and dfsg documents Diederik de Haas <didi.debian@cknow.org> - 2021-09-09 12:20 +0200

csiph-web