blog: Add planning meeting notes for 12 August

Signed-off-by: Daniel Silverstone <dsilvers@digital-scurf.org>

1 files changed, 151 insertions, 0 deletions

diff --git a/blog/2023/08/planning-2023-08-12.mdwn b/blog/2023/08/planning-2023-08-12.mdwn
new file mode 100644
index 0000000..bb7b632
--- /dev/null
+++ b/blog/2023/08/planning-2023-08-12.mdwn
@@ -0,0 +1,151 @@
+[[!meta title="Iteration planning: August 12–26"]]
+[[!meta date="2023-08-12 13:30:00 +0100"]]
+[[!tag meeting]]
+
+[[!toc levels=2]]
+
+[previous meeting]: /blog/2023/07/planning
+[subplot-container-images]: https://gitlab.com/subplot/subplot-container-images
+[subplot-web]: https://gitlab.com/subplot/subplot-web
+[subplot]: https://gitlab.com/subplot/subplot
+
+# Assessment of the iteration that has ended
+
+The previous iteration was [[!ms 12]].
+
+There were no actions from the [previous meeting][].
+
+We have made good progress and have nearly finished goal 3. See below
+for what's left.
+
+# Discussion
+
+## 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 reviewed issues (see below) and MRs. We made the decision
+to keep the reference test MR open until the release process during
+the next iteration.
+
+We also checked in on CI pipelines for all the projects in the [Subplot
+group](https://gitlab.com/subplot) on gitlab.com.
+
+| Repository                   | Open issues | Closed issues | Open MRs | Merged MRs |          CI |
+| :--------------------------- | ----------: | ------------: | -------: | ---------: | ----------: |
+| [subplot-container-images][] |           0 |             5 |        0 |          3 | OK (GitLab) |
+| [subplot-web][]              |           0 |             4 |        0 |         86 |    OK (Ick) |
+| [subplot][]                  |          47 |           283 |        0 |        340 | OK (GitLab) |
+
+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_
+  - Our plan is to wait until we can do `cargo update` using the Rust
+    toolchain in Debian `testing` without having to adjust any of the
+    dependencies to newer version, before we approach Debian about
+    packaging Subplot.
+  - We hope that an active Debian developer has interest in Subplot,
+    as we neither in position to actively help in maintaining packages
+    in Debian of Subplot and its dependencies. Time will tell if this
+    happens.
+
+## What's remaining for current goal?
+
+We resolved all the main issues we identified last month around goal 3
+but there are still two issues left with the goal 3 label.
+
+- [[!subplotissue 305]] _Maybe create binary release?_ remains as the
+  officially last thing we need to do for goal 3
+- [[!subplotissue 330]] _Re-enable reference.md after next release_
+  which needs to be done once the goal 3 release is completed.
+- [[!subplotissue 332]] _Define and document clearly ... breaking change_
+  needs to be compeleted so that we do not accidentally break things
+  in the future.
+
+# 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 the quality of life of people using Subplot:
+
+- we'll improve the ease of use and comprehension of the output of
+  documents generated by Subplot
+- we'll improve the documentation of Subplot itself
+- we'll make error messages and other diagnostics more helpful for
+  users to fix whatever the problem is
+
+We aim to have a fairly short and time-boxed goal 4, maybe on the
+order of two or three months. The goal 3 duration (well over a year)
+was long enough to be de-motivating to use as developers. Thus, we
+scope our actual tasks so that they are likely to be achieved by us,
+given our time and energy constraints. We'd rather have more frequent
+small goals than more ambitious goals that take a long time to
+achieve.
+
+([Related issues on gitlab](https://gitlab.com/subplot/subplot/-/issues?label_name%5B%5D=goal%3A%3A4))
+
+# Plan for new iteration
+
+## Issues
+
+We did a very brief skim of recent issues and decided on what we needed
+for this final iteration which we wanted to keep pretty lightweight,
+but with a release at the end to complete goal 3 - we will make that
+release in person together at our next meeting.
+
+We created [[!ms 13]] with the following issues:
+
+- [[!subplotissue 305]] _Maybe create binary release?_ remains as the
+  officially last thing we need to do for goal 3
+  - Lars and Daniel to discuss and explore this further. If we choose
+    not to do this for goal 3 it will not be a problem
+- [[!subplotissue 330]] _Re-enable reference.md after next release_
+  which needs to be done once the goal 3 release is completed.
+- [[!subplotissue 332]] _Define and document clearly ... breaking change_
+  needs to be compeleted so that we do not accidentally break things
+  in the future.
+- [[!subplotissue 333]] _Make a release_
+  In order to complete goal 3 we must make a release, so here we go.
+
+After these are all done, we have finished goal 3.
+
+We also labelled [[!subplotissue 303]] with fixed-in-next-version.
+
+## Actions
+
+No additional actions.
+
+# Meeting participants
+
+- Daniel Silverstone
+- Lars Wirzenius