On Sun, Sep 30, 2018 at 10:24 PM Björn Persson <Bjorn@rombobjörn.se> wrote:

Zbigniew Jędrzejewski-Szmek wrote:
> On Fri, Sep 28, 2018 at 02:02:37PM +0200, Igor Gnatenko wrote:
> > We have moved packaging guidelines onto docs.fedoraproject.org[0].
> > If you find any error or would like to change something, don't hesitate to
> > open ticket or submit pull request for packaging committee repo[1].
>
> Hmmm, comparing https://docs.fedoraproject.org/en-US/packaging-guidelines/Python/#_automatically_generated_dependencies
> and https://fedoraproject.org/wiki/Packaging:Python#Automatically_generated_dependencies
> doesn't make me happy.

That doesn't look too bad compared to
https://docs.fedoraproject.org/en-US/packaging-guidelines/Ada/.
Raw markup is displayed instead of links, wildcard characters have been
turned into stretches of bold font, while asterisks that were supposed
to become bold font are displayed instead, HTML var tags have been
removed and replaced with nothing at all, and there is inconsistent use
of monospace font, inconsistent quotation marks, and a stray grave accent
as a cherry on top.

That's what happens when one writes documents in a haphazard ad-hoc
markup language tied to a certain tool, and then tries to switch to
another tool that expects another haphazard ad-hoc markup language.

I was going to try to fix up the Ada guidelines. Obviously I need to be
able to generate HTML from the .adoc file, because the only way to write
in a haphazard ad-hoc language is to make haphazard ad-hoc changes,
preview the result, and repeat until it looks good. Following the
instructions in README.md I installed the package "podman" and ran
"make". After downloading six blobs of unknown contents it failed with
these error messages:

ERRO[0232] could not find slirp4netns, the network namespace won't be configured: exec: "slirp4netns": executable file not found in $PATH
error: getaddrinfo EAI_AGAIN asamalik.fedorapeople.org:443

Seems that podman is broken (it is also broken for tibbs in some other way), this is really sad. Just wondering which version of fedora you are running and is there really no package called "slirp4netns" (I can see it in F28/F29/F30).

I couldn't find any package that provides "slirp4netns", so that was a
dead end. Then I tried the command "asciidoc", because README.md says
that the guidelines are supposed to be written in Asciidoc. That
produced even worse HTML than that at docs.fedoraproject.org, with plus
signs everywhere and a partially mangled bullet list. Apparently the
Asciidoc that these documents are written in isn't the Asciidoc that
asciidoc understands.

This was a disappointing experience. I thought the ability to merge
changes with Git would make it easier to submit changes to the
guidelines. Instead it seems to have become harder. In the wiki I could
at least preview my changes.

I'm sorry to hear this, try using `sudo docker` in Make file instead of `podman`. Reason I choose to use podman is that you don't have to be root in order to run it.

By the way, the way that Pagure tries to syntax-highlight the .adoc
files is very confusing. I don't know which language Pagure tries to
syntax-highlight – or rather which two languages, because the way it
sprinkles colors over the file in the "blame" view is entirely different
from what it does in the "blob" view – but it needs to be taught that
these files aren't either of those languages.

I think this is known and should be improved (soon?). There was a ticket about this in pagure, but I can't find it right now.

Björn Persson
_______________________________________________
devel mailing list -- devel@lists.fedoraproject.org
To unsubscribe send an email to devel-leave@lists.fedoraproject.org
Fedora Code of Conduct: https://getfedora.org/code-of-conduct.html
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org