On Wed, 2016-09-07 at 22:08 +0200, Brian Exelbierd wrote:
Hi All,
A chance conversation today led me to thinking about semantic markup
and
AsciiDoc. AsciiDoc is easier to write because it has fewer tags. It
is
also easier because it has fewer keystrokes. However, it doesn't
offer
a lot of options for marking up elements to:
* ensure consistency of localization by passing element information
to
the localizer
* ensure consistency of formatting by ensuring all of the same
elements,
for example command names, are marked up the same way
* allow for future automated testing with a project like `emender`
I went through the Installation Guide and found 97 DocBook XML tags.
I've put them in the table on this wiki page:
https://fedoraproject.org/wiki/Docs_Tag_Discussion
A long, long time ago (2015!), I went through a similar process for
GNOME. For the curious, here's a couple blog posts, including a shell
script that will give you tag counts. (You'll need to change the path
where it looks for files.)
https://blogs.gnome.org/shaunm/2005/10/21/how-much-docbook/
https://blogs.gnome.org/shaunm/2005/10/22/how-much-docbook-internals/
>
> Please visit the page and edit it to weigh in on preferences about
> the
> tags.
>
> I believe this will help us complete our AsciiDoc style guide and do
> the
> conversions more rapidly and effectively.
>
> Today, if you want to discuss implementation of these tags in
> AsciiDoc,
> please start a separate email thread.
>
> Thank you.
>
> regards,
>
> bex
> --
> docs mailing list
> docs(a)lists.fedoraproject.org
> To unsubscribe:
>
https://lists.fedoraproject.org/admin/lists/docs@lists.fedoraproject.
> org