From 7d8cbe7ef588eed0122293f561e56c3b7a032e41 Mon Sep 17 00:00:00 2001 From: Lars Wirzenius Date: Sat, 19 Nov 2022 14:00:58 +0200 Subject: docs: meeting minutes for today's meeting Sponsored-by: author --- blog/2022/11/19/planning.mdwn | 132 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 132 insertions(+) create mode 100644 blog/2022/11/19/planning.mdwn diff --git a/blog/2022/11/19/planning.mdwn b/blog/2022/11/19/planning.mdwn new file mode 100644 index 0000000..c7090c0 --- /dev/null +++ b/blog/2022/11/19/planning.mdwn @@ -0,0 +1,132 @@ +[[!meta title="Iteration planning: November 19 – December 03"]] +[[!meta date="2022-11-19 15:30:00 +0000"]] +[[!tag meeting]] + +[[!toc levels=2]] + +# 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: + +- **NOT DONE:** [[!webissue 4]] -- _Review FAQ_ +- **DONE:** [[!subplotissue 309]] -- _Lars needs a Subplot release_ +- **DONE:** [[!subplotissue 291]] -- _User guide/book_ +- **NOT DONE:** [[!subplotissue 305]] -- _Maybe create binary releases?_ + +We got some work done, if less than we hoped for. + +# 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'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](https://gitlab.com/subplot) on gitlab.com. + +### [Subplot Container Images](https://gitlab.com/subplot/subplot-container-images) + +- Open issues: 1 +- Merge requests: 0 +- Additional branches: 0 +- CI: OK, ran yesterday + +### [subplot-web](https://gitlab.com/subplot/subplot-web) + +- Open issues: 1 +- Merge requests: 0 +- Additional branches: 0 +- CI: Ick, OK. + +### [subplot](https://gitlab.com/subplot/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`](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 + +# 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. 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](https://gitlab.com/subplot/subplot/-/issues?label_name%5B%5D=goal%3A%3A4)) + +# Plan for new iteration + +## Issues + +We spoke about: + +- [[!subplotissue 310]] -- _Subplot uses clap v3, should use clap v4_ + - Daniel wants to do it this iteration + +We intend to work on the following issues +([[!ms 8]]), mostly carried over from the previous iteration: + +- [[!webissue 4]] -- _Review FAQ_ +- [[!subplotissue 305]] -- _Maybe create binary releases?_ +- [[!subplotissue 310]] -- _Subplot uses clap v3, should use clap v4_ + +## 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 -- cgit v1.2.1