Subject: [bug#57643] [PATCH 0/3] Document the image API.

From: Ludovic Courtès <[email-masked]>
Date: Sat, 24 Sep 2022 12:15:21 +0200

Mathieu Othacehe <[email-masked]> skribis:

> * doc/guix.texi ("System Images"): New chapter.

[...]

> +@node Instantiate an Image
> +@section Instantiate an Image
> +
> +Let's say you would like to create an MBR image with three distinct
> +partitions:
> +
> +@itemize
> +@item ESP vfat partition of 40MiB at offset 1024KiB.

Maybe:

  @item The @acronym{ESP, EFI System Partition}, a partition of
  40@tie{}MiB at offset 1024@tie{}KiB with a vfat file system.

> +@item DATA ext4 partition of 50MiB containing a dummy data file.

  @item an ext4 partition of … data file, and labeled ``data''.

> +@item ROOT ext4 bootable partition containing the @code{%simple-os}

Likewise.

This section looks great!