blob: ed355312eeda77901f3bf918eff31848ece3e5f4 (
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
|
[[!meta title="Iteration planning: February 13th"]]
[[!tag meeting]]
[[!meta date="2021-02-13 16:30"]]
[[!toc levels=2]]
# Review of actions from last meeting.
- Dan remains not in a position to work on [[!issue 22]] which is fine, it can
wait until he is able to help. We're carrying this action
- Lars removed the roadmap from the subplot website.
- Daniel redid [[!issue 148]] as a tracking issue in [[!issue 163]].
- We carry the action to create issue templates.
# Review of the iteration that has ended
We completed some of the work we'd hope on getting done for [[!milestone 22]],
we missed out on a number of the files library related work, and the
work on redoing the CLI was not complete. Some documentation, and the pairing
with Dan on [[!issue 22]] were also not completed..
We did achieve:
- [[!issue 158]] - Implementation of `lib/files` extensions for Rust.
Remaining work on `lib/files` extensions are for Python ([[!issue 157]]) and
for Bash ([[!issue 159]]). These are tracked in [[!issue 155]].
- [[!issue 156]] - Environment variables for Rust runcmd implementation.
- [[!issue 152]] - Runcmd prepend to path testing for Python implementation.
- [[!issue 97]] - Subplot's subplot can now run against installed Subplot.
Lars did work in [[!mr 133]] toward [[!issue 116]] but didn't close the issue
because we're not sure if this is enough yet. We moved the issue to the new
iteration and assigned it to Daniel. Finally [[!issue 153]] wasn't done but
we should get it done so we've moved it to the new milestone and assigned it
to Lars.
# Review of the repositories
There were no pending merge requests for subplot-web. There is a WIP MR
for some work Daniel is doing in subplot.
There was a spare fix-156 branch for some reason in subplot, we deleted it.
The remaining branch in subplot is for the WIP MR mentioned above.
There were no extra branches in subplot-web.
# Issue review
- [[!issue 108]] (testing against other working subplots) has been put into the
new iteration.
- [[!issue 162]] (`./check` should deny warnings) has been put into the new
iteration but not assigned since either of us could do it.
Therefore there we placed 10 issues in the iteration.
# General discussion
## Documentation
We discussed the "four kinds of documentation" approach described
[here](https://documentation.divio.com/).
We agreed that we need tutorials, though the one we have may be sufficient for
our current goal, so long as it's updated and cleaned up.
We may be able to avoid writing howtos until we have some interested users asking
questions. It may be better therefore to ensure we have a "how to ask questions".
The material we currently have is a cross between discussion and reference and so
we may get away without writing more of that for now.
Eventually we're going to want tooling to test tutorials etc. But we don't need
that for now.
Our consensus is that we should adopt this documentation process and we updated
[[!issue 118]] to mention the process ready for when we want to write that first
tutorial properly.
# Current goal
Our current goal is to get Subplot the software and project into such
a shape that we feel confident that we can ask a few people to give it
a proper try. This requires for Subplot to have releases that are be
easy to install, tolerably easy to use, and to have at least some
rudimentary documentation aimed at beginners.
# Plan for next iteration
We created [[!milestone 23]] for the iteration starting now and ending
in two weeks on 2021-02-27.
We picked the following issues to work on for Lars:
- [[!issue 108]]
- [[!issue 153]]
- [[!issue 157]]
- [[!issue 159]]
For Daniel:
- [[!issue 164]]
- [[!issue 161]]
- [[!issue 116]]
Up for grabs if anyone has time:
- [[!issue 22]] depends on Dan's availability.
- [[!issue 162]]
- [[!issue 155]] is a tracking issue, to be closed once its sub-issues
are closed.
# What do we need to persuade others?
We adjusted the description of [[!issue 125]] to indicate that Python will be
sufficient for the tutorial.
We also updated [[!issue 119]] to be directly blocked by [[!issue 66]] so that
we're more aware that we need the cargo installability sorted before it becomes
plausible for someone to package Subplot properly for Debian.
# Actions
- Lars or Daniel to schedule pairing session with Dan to help him work
through [[!issue 22]].
- Daniel to file an issue to create issue templates based on
<https://third-bit.com/2021/01/18/how-to-write-a-memo/>.
|
