iteration planning meeting minutes, async

Sponsored-by: author

1 files changed, 167 insertions, 0 deletions

diff --git a/blog/2023/05/20/planning.mdwn b/blog/2023/05/20/planning.mdwn
new file mode 100644
index 0000000..92ae1e3
--- /dev/null
+++ b/blog/2023/05/20/planning.mdwn
@@ -0,0 +1,167 @@
+[[!meta title="Iteration planning: May 20 – June 03"]]
+[[!meta date="2023-05-02 15:30:00 +0000"]]
+[[!tag meeting]]
+
+[[!toc levels=2]]
+
+# Assessment of the iteration that has ended
+
+Actions from the previous meeting:
+
+- DONE: Daniel to determine what happened and ensure we won't lose our
+  OSS SaaS subscription.
+  - we're good for another year
+- NOT DONE: Lars to produce a list of dependencies of Subplot, for
+  [[!subplotissue 119]].
+  - carried over to this new iteration
+- DONE: Lars to change the MRSV CI pipeline to NOT run clippy or
+  formatting checks.
+  - [[!mr 323]]
+
+We made progress, if not quite all we planned in the previous planning
+meeting. The highlight of the past month is that Subplot now allows
+any number of markdown files to be used ([[!subplotissue 318]]).
+
+We're getting close reaching the current goal. This feels good.
+
+
+We had an in-person meeting and decided to extend the iteration until
+today. There were pancakes.
+
+# Discussion
+
+## Async meeting
+
+Due to scheduling problems, we couldn't do a synchronous video meeting
+today, so we're doing this async using a merge request.
+
+## The gitlab.com hosting situation
+
+We reviewed [the billing
+page](https://gitlab.com/groups/subplot/-/billings) for Subplot on
+gitlab.com. It all looks OK.
+
+We will review the billing page every iteration or two.
+
+
+## Repository review
+
+We didn't review any issues, but did review merge requests, and CI
+pipelines for all the projects in the [Subplot
+group](https://gitlab.com/subplot) on gitlab.com.
+
+| Repository                                                                      | Open issues | Closed issues | Open MRs | Closed MRs |          CI |
+| :------------------------------------------------------------------------------ | ----------: | ------------: | -------: | ---------: | ----------: |
+| [subplot-container-images](https://gitlab.com/subplot/subplot-container-images) |           1 |             4 |        0 |          3 | OK (GitLab) |
+| [subplot-web](https://gitlab.com/subplot/subplot-web)                           |           1 |             3 |        0 |         82 |    OK (Ick) |
+| [subplot](https://gitlab.com/subplot/subplot)                                   |          51 |           270 |        1 |        320 | OK (GitLab) |
+
+The open MR in the subplot repository ([[!mr 331]]) didn't need
+discussing in the meeting, and is under ongoing review.
+
+Extra branches: none.
+
+## Recurring items issues
+
+There are some issues tagged
+[`recurring-agenda-item`](https://gitlab.com/groups/subplot/-/issues/?sort=created_asc&state=opened&label_name%5B%5D=recurring-agenda-item&first_page_size=20)
+in the issue tracker, which we discuss in every iteration meeting.
+
+- [[!subplotissue 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
+
+## What's remaining for current goal?
+
+We can re-enable `reference.md`, and then make a release. When we do,
+we should see if we can use GitLab CI to build an executable binary of
+the release.
+
+There is an optional task to split `subplot.md` into multiple files
+([[!subplotissue 235]]), which may involve rewriting some of it using
+what we've learned about writing good subplots. However, that is a
+large task, and may need to be postponed, or splitting it into smaller
+tasks.
+
+# 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](https://gitlab.com/subplot/subplot/-/issues?label_name%5B%5D=goal%3A%3A3))
+
+## Goal 4: Planned
+
+This goal is very likely to change. It will need to be discussed in
+depth when we finish the previous goal.
+
+We'll improve documentation and generally aim at making Subplot more
+plausibly usable by people outside of the Subplot project.
+
+([Related issues on gitlab](https://gitlab.com/subplot/subplot/-/issues?label_name%5B%5D=goal%3A%3A4))
+
+# Plan for new iteration
+
+## Issues
+
+We think we can finish goal 3 this iteration. We intend to work on the
+following issues ([[!ms 10]]).
+
+- [[!subplotissue 119]] -- _Subplot is in not in Debian unstable_
+  - Lars to produce a list of crates in the Subplot dependency graph
+    that aren't in Debian bookworm. This doesn't fully resolve the
+    issue, but is a necessary step forwards.
+- [[!subplotissue 268]] -- _Re-enable reference.md_
+  - Also requires fixing up any problems that crop up.
+  - Assigned to Lars, who is eager to finish goal 3.
+- [[!subplotissue 305]] -- _Maybe create binary releases?_
+  - Assigned to both Daniel and Lars. Should be done as part of, or
+    just after the release for this iteration.
+- [[!subplotissue 323]] -- _Make release to mark end of goal 3_
+  - Assigned to Daniel.
+
+Stretch goals for this iteration, to be completed if there's time and
+energy, or dropped from the iteration if not:
+
+- [[!subplotissue 96]] -- _Error for "do not understand binding"
+  should say in what file the not-understood binding use is found_
+  - To implement this, add location information to `Scenario` and
+    `ScenarioStep`, and to the `BindingUnkown` error variant.
+  - Assigned to Lars, who has been doing error location changes
+    recently.
+- [[!subplotissue 235]] -- _The Subplot subplot (`subplot.md`) is too long_
+  - Lars to split up the long file into shorter ones. This doesn't
+    necessarily fully resolve the issue as it doesn't update the
+    contents to follow what we now think are best practices, but it's
+    a step forward at least.
+- [[!subplotissue 317]] -- _Lacks a way to force `docgen` to produce output_
+  - Lars keeps being annoyed by this. Might just drop the "do we
+    really need to write output?" feature or turn it into optional
+    behavior.
+- [[!subplotissue 319]] -- _https://subplot.tech/ has broken links to examples_
+  - Lars runs a cron job to check links and will amend it to find the
+    broken links, and then submit an MR anything found by the link checker.
+- [[!subplotissue 322]] -- _Subplot should warn in code block has identifier, but no .file attribute_
+  - Lars will try to do this, as it's something that recently annoyed
+    him.
+
+## Actions
+
+No additional actions this time.
+
+
+# Meeting participants
+
+- Daniel Silverstone
+- Lars Wirzenius