summaryrefslogtreecommitdiff
path: root/blog/2019/12/08/iteration_planning_notes_december_7.mdwn
blob: 1bd19e4b7fa5e0b94674f7a179b645aa0aba155d (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
[[!meta title="Iteration planning notes: December 7"]]
[[!tag meeting]]
[[!meta date="2019-12-08 11:50"]]

# What has happened

* Due to work, life, and travels, things have been quiet.

* Lars has gotten the document generator to do typesetting informed by
  step bindings: captured parts of scenario steps are now typeset
  in a different font. This has required writing some internal
  infrastructure for parsing and handling bindings, and that will be
  useful going forward, when we start work on code generation.

* Daniel has provided wisdom, Rust mentoring, and code review.

# Discussion

* We discussed ways in which the current code is structured, and how
  that could be improved. The current structure is not entirely
  idiomatic for Rust, which we hope to improve.

  - combine things that belong together into the same modules
  - use Rust features to limit what's exported from the crate to its
    users
  - ask compiler to warn or error if there's missing documentation
  - add better error types

* We discussed code generation. We'll start with a language that's
  simple for us to generate (shell or Python), and do a minimal
  version to start with. Then we'll migrate to using templating for
  code generation, so it's easier to add suppor for more output
  languages.

# Actions

* Lars to update roadmap.

* Lars to do suggested cleanup of Subplot code base, and publish a new
  version of the crate on crates.io.

* Daniel to do code review and mentor.

* Both to reschedule the next chat session for when we have time.