Uploaded image for project: 'WildFly'
  1. WildFly
  2. WFLY-18250 Create an SE support matrix document
  3. WFLY-18548

Create POC of a wildfly.org support matrix document based on _data/releases

XMLWordPrintable

    • Medium
    • ---
    • ---

      This is an opportunity to learn a bit about Quarkus Roq and Qute, appropriate for someone with experience in those technologies, or someone who is willing to do some homework to learn. (Roq is easy, so this shouldn't be a big deal.)

      The wildlfy.org site is a github pages site driven by Quarkus Roq.[1] The https://github.com/wildfly/wildfly.org/blob/main/data/releases.yaml file provides data that drives some of the site, particularly the https://www.wildfly.org/downloads/ page. The https://github.com/wildfly/wildfly.org/blob/main/templates/layouts/downloads.html file illustrates a bit about how data from the releases file is used in a Jekyll template.

      The goal of this subtask is to develop a POC of a WFLY-18250 solution by adding some new attributes to the entries in the releases file, and to use those to create a "data" file available on wildfly.org.

      Specifically:

      1) Work out based on discussion on zulip[2] what the data structure is for the new attributes. For example, a 'se-support' object attribute with child attributes for different categories of 'support' (see WFLY-18250 for thoughts on categories.)

      2) Work out based on discussion on zulip a structure for the output file. Not HTML; this is meant for machine reading. So XML, or yaml or ...

      3) Determine a stable url for 2)

      4) Add a layout that uses Qute[2] to go from 1) to 2).

      5) Add the release support data to releases 26.1.0 and later.

      The expectation is whoever works on this will be able to work out largely on their own from the https://github.com/wildfly/wildfly.org/blob/main/README.md content how to use Roq and how to set up a local environment and locally build the site in order to validate their work. They can count on assistance from WildFly developers though in discussing the best form of input and output data.

      [1] https://docs.quarkiverse.io/quarkus-roq/dev/index.html
      [2] https://wildfly.zulipchat.com/#narrow/channel/174184-wildfly-developers
      [3] https://quarkus.io/guides/qute

              Unassigned Unassigned
              bstansbe@redhat.com Brian Stansberry
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated: