missing nodes from docbook -> markdown conversion?

[abathur]

I'm picking at some text in the install section and noticed some bullet points that don't make much sense in context.

In this specific case I suspect the itemizedlist's title wasn't supported and was lost in translation. But I bring it up mostly to document the general case, since there may be other places where the text makes less sense post-conversion.

Docbook:

<section xml:id="sect-multi-user-installation">
  <title>Multi User Installation</title>
  <para>
    The multi-user Nix installation creates system users, and a system
    service for the Nix daemon.
  </para>

  <itemizedlist>
    <title>Supported Systems</title>

    <listitem>
      <para>Linux running systemd, with SELinux disabled</para>
    </listitem>
    <listitem><para>macOS</para></listitem>
  </itemizedlist>

  <para>
    You can instruct the installer to perform a multi-user
    installation on your system:
  </para>

Manual:

Markdown:

# Multi User Installation

The multi-user Nix installation creates system users, and a system
service for the Nix daemon.

  - Linux running systemd, with SELinux disabled

  - macOS

You can instruct the installer to perform a multi-user installation on
your system:

[zimbatm]

At a glance, I am not seeing the issue. What would the proper output look like?

[abathur]

The markdown is missing the text of the itemized list title, so it just has two list items injected with no context. It should probably look more like (I've made this specific edit in the PR I'm working on):

# Multi User Installation

The multi-user Nix installation creates system users, and a system
service for the Nix daemon.

**Supported Systems**
- Linux running systemd, with SELinux disabled
- macOS

You can instruct the installer to perform a multi-user installation on
your system:

[stale[bot]]

I marked this as stale due to inactivity. → More info