1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
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
|
