discuss: [questions] WikiText format; Bugzilla-Guide; unpublished; suggested renaming
Subject:
[questions] WikiText format; Bugzilla-Guide; unpublished; suggested
renaming
From:
"Martin A. Brown" ####@####.####
Date:
2 Feb 2016 20:11:39 +0000
Message-Id: <alpine.LSU.2.11.1602021152190.2025@znpeba.jbaqresebt.arg>
Hello all,
I have a few questions:
1. What to do with WikiText format and our one WikiText document?
2. OK to retire very old Bugzilla-Guide?
3. Unpublished source documents: should we contact authors?
4. Propose renaming of some templates.
1. What to do with WikiText format and our one WikiText document?
-----------------------------------------------------------------
We have exactly one WikiText document (out of 501 active documents)
in our source repository, the howto/wikitext/WikiText-HOWTO.
What should we do with this WikiText document?
David Merrill, our illustrious former leader, seems to be the author
both of this document and of a perl module backing the CLI utility,
wt2db (WikiText to DocBook).
Should this be enqueued to the discussion of our future list of
supported formats?
For now, I'm ignoring this single document.
[Since the time that TLDP supported wiki markup and today, there has
been a proliferation of markup languages. AsciiDoc, reStructuredText
and Markdown have overtaken WikiText for general applications,
although WikiText seems to dominate the ... wiki ... spaces. Thank
you, Captain Obvious.]
2. OK to retire very old Bugzilla-Guide?
----------------------------------------
We have a very old version of the Bugzilla Guide, which treats
Bugzilla version 2.16.3. The Bugzilla folk are now at version 5.0
or something and they have a comprehensive set of documentation
online.
I propose that we retire the guide/docbook/Bugzilla-Guide.
[If nobody objects within a week or so, I'll do this.]
3. Unpublished source documents: should we contact authors?
------------------------------------------------------------
We have several unpublished source documents. A few of them, I
believe are quite high quality (Intro-Linux and
Bash-Scripting-Introduction-HOWTO). I will also observe that one of
my owns documents (linux-ip) is also unpublished on tldp.org today.
I propose contacting the authors and asking each if s/he is
interested in having the documentation published on tldp.org.
Bash-Scripting-Introduction-HOWTO
(howto/docbook/Bash-Scripting-Introduction-HOWTO)
Consultants-Guide (guide/docbook/Consultants-Guide)
GNU-Build-System-HOWTO (howto/docbook/GNU-Build-System-HOWTO)
Intro-Linux (guide/docbook/Intro-Linux)
linux-ip (guide/docbook/linux-ip)
Linux-Networking (guide/docbook/Linux-Networking)
rpmupgrade (howto/docbook/rpmupgrade)
Tuning-Linux (guide/docbook/Tuning-Linux)
[If nobody objects within a week or so, I'll do this.]
4. Propose renaming of some templates.
--------------------------------------
We have sample docs of several formats.
I propose renaming these:
big-howto-template-ld.sgml -> Template-Linuxdoc-Big-HOWTO
small-howto-template-ld -> Template-Linuxdoc-Small-HOWTO
I propose also renaming these two DocBook SGML/XML documents and
switching them to DocBook XML 4.2:
Template-Big-HOWTO -> Template-DocBook-Big-HOWTO
Sample-HOWTO -> Template-DocBook-Small-HOWTO
[If nobody objects within a week or so, I'll do this, as well.]
That's my update for now,
-Martin
--
Martin A. Brown
http://linux-ip.net/
