#837 Empty sections in release notes are confusing
Closed by pbokoc. Opened by scfc.

On a new Fedora release, I go to the web (https://docs.fedoraproject.org/en-US/fedora/latest/release-notes/) for that version's release notes to see what changes I will have to take into account when updating. There have been and are sections in that web release notes that are empty, like for example currently https://docs.fedoraproject.org/en-US/fedora/latest/release-notes/sysadmin/Printing_Scanning/ and https://docs.fedoraproject.org/en-US/fedora/latest/release-notes/sysadmin/Storage/.

When I encounter those, my thought process and workflow is typically:

  1. My browser has failed to load some hyper-reactive, but brittle widget or this is a section with an empty introductory text, but non-empty subsections, but the menu on the left has not updated itself, so I try to reload. (This is confounded by the lack of "navigation buttons" that allow to read a Fedora document in a serial manner, like SPC would in an info document.)
  2. Fedora's publishing engine failed to format some really important notes ("all disks will be wiped clean on update"), so I have to check the Git repository.
  3. The section in the Git repository has been unchanged for the past year, the empty web version is verbatim, I do really hope someone paid more attention to the contents than to the presentation or its quality control.

To avoid this confusion, three solutions come to mind:

  1. Empty sections are filtered out in the publication pipeline. (I don't know if this is possible with Antora.)
  2. Empty sections and their references are manually deleted when there no entries for this version and restored/created when they are needed again. (This would be nice, but tedious.)
  3. À la "This page intentionally left blank.", sections are not emptied, but instead left with a sentence "There have been no user-visible updates in this section." or something similar.

Yeah, that was annoying. It won't be a problem starting with F40, we're using a script to autogenerate empty relnotes and we flattened the structure so that the content only has 3 large pages instead of a bunch of subsections.

Metadata Update from @pbokoc:
- Issue status updated to: Closed (was: Open)

Metadata