summaryrefslogtreecommitdiff
path: root/blog/2021/12/04/planning.mdwn
blob: 42ba5b001d32c6e328c80a81ba14582ff771e781 (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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
[[!meta title="Iteration planning: December 4th"]]
[[!tag meeting]]
[[!meta date="Sat, 04 Dec 2021 15:30:00 +0200"]]

[[!toc levels=2]]

# Review of actions from previous meeting

Actions from last time, and their status are:

* Daniel and Lars to keep an eye on the FOSDEM CfP (30th Nov) and
  together decide if/where to submit a talk.
  - we had a preview of the CFP for the "safety and open source"
    devroom
  - there's no deadline for the CFP responses yet, but we'd like to
    submit our proposal early, within a week
  - we'll need to have a title, subtitle, one-paragraph abstract, an
    optional longer description, and some relevant links

# Review of the iteration that has ended

[[!milestone 40]] had the following issued closed:

- [[!issue 180]] _Doesn't warn about unused embedded files_
- [[!issue 198]] _Unify language handling for multi-impl-lang test suites_
- [[!issue 241]] _./check doesn't build/test all of the workspace_
- [[!issue 242]] _`subplotlib` doesn't use `build.rs` script_

Additionally, we upped the Minimum Supported Rust Version to 1.56
([[!issue 258]]).

We made little progress on:

- [[!issue 133]] _No feature table comparing scenario runners from different codegen templates_
- [[!issue 218]] _Automatable parts of release process are manual_
- [[!issue 253]] _Make release 0.3.2 or 0.4.0 of Subplot_
- [[!issue 221]] _Command line tool has insufficient logging_
- [[!issue 214]] _Lacks example and docs for using Rust step functions_

We made significant progress on:

- [[!issue 141]] _subplotlib: Needs better test suite_
  - Daniel did what he meant to do, but it's a tracking issue, and he
    opened a new blocker issue

We moved most of the remaining open issues to the next milestone
([[!milestone 41]]) and then closed off this iteration.

# Review of the repositories

Currently open MRs:

- `subplot`: none
- `subplot-web`: none
- `subplot-container-images`: none

Extra branches unrelated to MRs:

- `subplot`:
  - `subplot-rust` -- Daniel is keeping this around until he has
    completed the work on [[!issue 141]].
  - `docgen-cmark` -- Lars is working on making docgen use cmark
    rather than pandoc for the initial parse and processing.
- `subplot-web`: none
- `subplot-container-images`: none

Pipelines:

- `subplot`: clean
- `subplot-web`: none
- `subplot-container-images`: clean, and we triggered the one to build
  a new container image

# Current goal (goal 2; not changed for this iteration)

Subplot provides a set of libraries with identical capabilities in
each of the supported languages. Python remains a supported language.
Rust is promoted to supported-language status. Subplot will be tested
with all supported languages. In addition, any quality of life
improvements which can be done shall be done. This goal will be
considered complete when a release of Subplot has been made with the
unified language handling support complete.

# Length of this iteration

The year-end holidays are coming, so we decided to make this a
month-long iteration. The next planned meeting is January 1.

# Issue review

We had 51 open issues at the start of the meeting.

We reviewed non-`someday-maybe` issues for `subplot` that have been
changed since thee previous meeting.

We made the following changes:

- [[!issue 214]] _Lacks example and docs for using Rust step functions_
  - put into iteration
  - assigned to Lars
- [[!issue 251]] and [[!issue 252]] will probably go away now that our
  MSRV has been raised
- [[!issue 255]] __
  - uses of the word graph exposed to users should change, but it's
    not urgent
  - we adjusted labels
- [[!issue 256]] _Lacks way to mark an embedded file as being OK that
  it's not used in a scenario_
  - adding `.example` that's like `.file`, with the same typesetting,
    but that can't be used as an embedded file is probably the way to
    go
  - adjusted labels
- [[!issue 259]] _Top level subplots should be run in Rust too_
  - put into iteration
  - assigned to Daniel
  - adjusted labels

We left the docker-for-subplot issue alone, and subplot-web had no issues.

# Other discussion

- We had a discussion and agreed that goal 2 doesn't need significant
  QoL changes right now. We may drop of the issues currently assigned
  to goal 2.

# Plan for next iteration

We opened [[!milestone 41]] to cover this iteration, with the
following issues:

- [[!issue 133]] _No feature table comparing scenario runners from different codegen templates_
- [[!issue 141]] _subplotlib: Needs better test suite_
- [[!issue 207]] _Release process is too manual, CI build of release .deb changes files_
- [[!issue 214]] _Lacks example and docs for using Rust step functions_
- [[!issue 218]] _Automatable parts of release process are manual_
- [[!issue 220]] _Generated Rust test programs are hard to debug_
- [[!issue 221]] _Command line tool has insufficient logging_
- [[!issue 250]] _subplotlib could do with unit tests_
- [[!issue 251]] _We depend on a vulnerable version of chrono_
- [[!issue 252]] _We transitively depend on a vulnerable version of time_
- [[!issue 254]] _Make release 0.3.2 or 0.4.0 of Subplot_
- [[!issue 259]] _Top level subplots should be run in Rust too_

# Other business

- We decided to make a release of whatever is in the `main` branch and
  label it 0.3.2 or 0.4.0, depending on whether it has breaking
  changes or not. [[!issue 254]]

- We are not yet ready to file an RFP bug to get Subplot packaged for
  Debian. It will happen after we think we won't be making breaking
  changes anymore. We probably want to do a review of the dependencies
  as well, to make packaging easier.

- We are not yet ready to make a whole code base review of Subplot.
  However we feel at least part of the new goal 3 will be reviewing a
  portion of the code. Lars made the `pandoc-filter-diagram` crate
  from Subplot code, and intends to refactor Subplot to use it
  eventually.

- We will switch an issue based agenda when other people join the
  meeting.

- We won't be reaching out for feedback until goal 3 is done.

- We'll aim at the FOSDEM "safety and open source" devroom for now.
  After we've made that talk, whether it's accepted or not, we will
  consider other conferences and also podcasts.

- Regarding the `media` repository question - we believe this is
  premature at this point - once we are ready to write the talk
  mentioned above, it will be time for the repository.

- Lars will be opening communications with the WMF around supporting
  their use of Subplot for `scap`.

# Actions

- Lars will open an issue to use pandoc-filter-diagram.

- Lars will approach WMF about how `scap` uses Subplot.