summaryrefslogtreecommitdiff
path: root/blog/2023/04/22/planning.mdwn
blob: b9ab01dc01f3e7b0bce8b63762a5b02eb54b72af (plain)
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
133
134
135
136
[[!meta title="Iteration planning: April 22–May 06"]]
[[!meta date="2023-04-22 15:30:00 +0000"]]
[[!tag meeting]]

[[!toc levels=2]]

# Assessment of the iteration that has ended

We've been lax about keeping minutes so far, this year, due to life,
work, and the dark winter time taking a toll on our ability to work on
Subplot. We have concentrated on making changes and less on taking
meeting minutes.

We have switched away from Pandoc, and no longer use it to parse
markdown input, or to produce typeset output. As part of that we have,
at least temporarily, dropped support for PDF output, and only support
HTML output. We're close to the end of the current goal now.

# Discussion

## Async meeting

Due to network 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'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.

The current period of GitLab granting us free resources as an open
source project is stated as coming to an end soon despite Daniel
requesting an extension.


## 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 |         81 |    OK (Ick) |
| [subplot](https://gitlab.com/subplot/subplot)                                   |          49 |           268 |        1 |        312 | OK (GitLab) |

We discussed the open merge requests:

- [[!mr 322]] (fix(src/codegen.rs): formatting)
  - apparently `cargo fmt` results in different formatting with
    different versions of the Rust toolchain, and so CI fails with the
    MSRV toolchain or the current toolchain
  - we should change the MSRV test to NOT run clippy or formatting
    checks

Extra branches:

- there is now only one extra branch, for [[!mr 322]]
- Lars deleted his old branches, now that we no longer use Pandoc

## 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 need to add support for multiple markdown input files (see
[[!subplotissue 318]]). Once this is done, we can re-enable
`reference.md`, and then make a release, and when we do, we should see
if we can use GitLab CI to build an executable binary of the release.

We decided to not worry about using marked data types. It's a good
idea, but not actually a blocker for the current goal.

# 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 intend to work on the following issues
([[!ms 9]]), mostly carried over from the previous iteration:

- [[!subplotissue 318]] -- _Lacks support for multiple markdown files_

## Actions

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

- Daniel to determine what happened and ensure we won't lose our OSS
  SaaS subscription.
- Lars to produce a list of dependencies of Subplot, for
  [[!subplotissue 119]].
- Lars to change the MRSV CI pipeline to NOT run clippy or formatting
  checks.

# Meeting participants

- Daniel Silverstone
- Lars Wirzenius