Change Displayers
Reference
A displayer is the layout a list of changes is rendered with. The custom report form offers the four below in a drop-down, and the displayChanges macro takes the same names in its displayer parameter. A release note uses simple for the changes that carry a screenshot and list for the others.
Grid
Cards laid out in columns, each holding the change title, then its media, then its summary. A card holds a single medium: the screenshots of the change when it has any, otherwise its first video, otherwise a placeholder picture. This is the default.
Release Notes Application <2.5 The media came above the title, the cards had no border of their own, and a change referencing several videos displayed all of them.
Flow
One row per change, with the media on the left and the title and summary on the right. A row holds the same single medium as a grid card, and the two halves sit side by side from medium screens up, stacking on anything narrower.
Release Notes Application <2.6.1 A change with no screenshot was given an empty column, the two halves stayed side by side at every width, and the medium started lower than the title beside it.
Simple
One section per change, with the screenshots in a gallery and a link to the change page when it has a description.
List
A bullet list of titles and summaries, with no screenshots. This is the compact form used for the miscellaneous changes.
FAQ
Can I add a displayer of my own?
Yes, by creating one page; see Create a Change Displayer.
Why does a change show a placeholder picture instead of a screenshot?
The grid and the flow give every change a medium, so a change carrying neither screenshot nor video gets the placeholder rather than a gap that would read as belonging to the change next to it.
