Subplot → blog → 2022 → 11 → 19 → Iteration planning: November 19 – December 03
  1. Actions from last time
  2. Assessment of the iteration that has ended
  3. Discussion
    1. The gitlab.com hosting situation
    2. Repository review
    3. Recurring items issues
  4. Goals
    1. Goal 3: Current goal
    2. Goal 4: Planned
  5. Plan for new iteration
    1. Issues
    2. Actions
  6. Meeting participants

Actions from last time

  • NOT DONE: Daniel to write up an issue describing configurable templates, how they would look from the user perspective, and from an implementation perspective. Then to request feedback from Heiko.
  • NOT DONE: Once that’s done, Daniel or Lars to write standalone mode for Rust template.

Assessment of the iteration that has ended

We had chosen the following issues for this iteration:

We got some work done, if less than we hoped for.

Discussion

The gitlab.com hosting situation

We reviewed the billing page for Subplot on gitlab.com. It all looks OK. We’re over the limit on seats, but it seems we can increase the seats for free.

We will review the billing page every iteration or two.

Repository review

We reviewed issues updated since the previous meeting, merge requests, and CI pipelines for all the projects in the Subplot group on gitlab.com.

Subplot Container Images

  • Open issues: 1
  • Merge requests: 0
  • Additional branches: 0
  • CI: OK, ran yesterday

subplot-web

  • Open issues: 1
  • Merge requests: 0
  • Additional branches: 0
  • CI: Ick, OK.

subplot

  • Open issues: 45
  • Merge requests: 0
  • Additional branches:
    • docgen-cmark, Lars is keeping this around for reference for future changes
  • CI: OK

Recurring items issues

There are some issues tagged recurring-agenda-item in the issue tracker, which we discuss in every iteration meeting.

  • subplot#119 – Subplot is in not in Debian unstable
    • we will work on reducing Subplot dependencies that aren’t already in Debian
    • need the dependency list; we are not targeting bookworm

Goals

Goal 3: Current goal

Subplot is altered to treat a YAML document as the root of any subplot document, permitting multiple markdown files to be joined into a single scenario set or output document. We remove our dependency on Pandoc’s AST for internal document representation, and support a better range of document metadata as a result. We will use marked data types where possible to permit better provenance information in error and warning messages; and we will strive to reenable the reference tests such that we can make a statement to the effect that post goal 3, we do not intend to make further breaking changes to the input formats or primary behaviours of Subplot.

(Related issues on gitlab)

Goal 4: Planned

This goal is very likely to change. This is merely an initial sketch.

We’ll improve documentation and generally aim at making Subplot more plausibly usable by people outside of the Subplot project.

(Related issues on gitlab)

Plan for new iteration

Issues

We spoke about:

  • subplot#310 – Subplot uses clap v3, should use clap v4
    • Daniel wants to do it this iteration

We intend to work on the following issues (Subplot milestone 8), mostly carried over from the previous iteration:

Actions

These are in addition to work on issues chosen for this iteration.

  • Daniel to write up an issue describing configurable templates, how they would look from the user perspective, and from an implementation perspective. Then to request feedback from Heiko.
  • Once that’s done, Daniel or Lars to write standalone mode for Rust template.
  • Lars to try to use the Markdown parser he wrote for his static site generator for Subplot.

Meeting participants

  • Daniel Silverstone
  • Lars Wirzenius