From 0e73d5da66f4de716f23146cb22b1d475f032f9f Mon Sep 17 00:00:00 2001 From: Daniel Silverstone Date: Sat, 18 Jul 2020 17:22:21 +0100 Subject: Add July 18 planning note Signed-off-by: Daniel Silverstone --- .../07/18/iteration_planning_note_july_18.mdwn | 72 ++++++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 blog/2020/07/18/iteration_planning_note_july_18.mdwn diff --git a/blog/2020/07/18/iteration_planning_note_july_18.mdwn b/blog/2020/07/18/iteration_planning_note_july_18.mdwn new file mode 100644 index 0000000..cfc4780 --- /dev/null +++ b/blog/2020/07/18/iteration_planning_note_july_18.mdwn @@ -0,0 +1,72 @@ +[[!meta title="Iteration planning note: July 18"]] +[[!tag meeting]] +[[!meta date="2020-07-18 18:00"]] + +# What has happened? + +We completed [[!issue 68]] and [[!issue 12]]. [[!issue 20]] remains incomplete +at this time. + +Lars has started to deal with the fallout of renaming the default branch to +be `main` in his ick configuration. + +We've agreed to dogfood this for a while in case something breaks, and think +about what we might change otherwise (e.g. the website repo) in the future. + +We agreed we were OK with all this and so closed [[!milestone 10]]. + +# Issue review + +We reviewed the situation for all the open issues, for the most part nothing +was changed, however the following tweaks were done: + +* Lars was reading an article about abstraction and coupling between modules, + which was of the opinion that inter-crate APIs are cleaner. Cargo enforces + a DAG on crates. He created [[!issue 53]] a while ago and has updated that + issue with a note on this. + - After some discussion, we decided to create [[!issue 69]] to cover the + splitting up of `ast.rs` and the factoring out of tests into independent + files. +* We linked [[!issue 27]] and [[!issue 36]] because they're both related to + styling. +* We determined that [[!issue 37]] was completed anyway and so closed it + +We agreed to continue with our current issue-filing and closing/keeping flow +the same for now. + +# Milestone planning + +New iteration is [[!milestone 11]] + +Contains: + +* [[!issue 20]] - Carried and still assigned to Daniel +* [[!issue 69]] - Assigned to Lars +* [[!issue 62]] - Assigned to Lars to drive discussion and writing of docs + +# Debugging test programs + +Lars started to change `ewww` so it would actually serve files. This involved +learning new things about `warp` which weren't too bad; but while learning them, +problems were encountered because initial guesses on how to work with it were wrong +and Lars had a devil of a time debugging the generated test program which was failing. + +The fundamental problem was that each scenario got a generated directory and since +that consumes disk space it deletes them after the program ends. This is fine +when the scenario passes but makes it harder to debug on failure. This is a +problem common to other tools such as `yarn`. + +We should attempt to make this experience as smooth as possible because it's +not going to be unusual for people to need to diagnose test failures. + +Daniel suggested adding 'keep on failure' or 'shell on failure' type approaches. + +Lars had spoken to a friend who suggested: + +1. 'on failure, make a data tarball/copy/whatever'. +2. 'on failure, open a shell prompt' +3. 'on failure, snapshot a container/vm/whatever' + +We decided that Lars will write a story about a successful debugging experience +with tooling which did all the right things, and from there we can derive +some initial requirements for subplot's built-in runner templates. -- cgit v1.2.1