Showcase manual sorting document (Jekyll 4.0)

[peterdesmet]

Jekyll 4.0 supports custom sorting for collection elements. Unfortunately, GitHub Pages currently uses 3.9.2: https://pages.github.com/versions/

In the meantime, Petridish will support custom sorting using the order property in the page frontmatter. It has 3 main drawbacks:

• Pages without order are placed before the others, while with the sort_by feature in Jekyll 4.0 they are placed after (more intuitive).
• You cannot sort elements without frontmatter (e.g. JSON files)
• You cannot use the more intuitive manual sorting, where you see all the pages in one list

To be picked up again once GitHub Pages supports Jekyll 4.0:

collections:
  docs:                                 # Settings for the "docs" collection
    output: true
    permalink: "/:collection/:path/"
    order:
      - installation.md
      - configuration.md
      - markdown.md

[peterdesmet]

Support for collections was removed, so manual order is not necessary.