add notes about TODO annotations; add component diagram

1 files changed, 24 insertions, 10 deletions

diff --git a/report.qmd b/report.qmd
index 5fc9e23..3529ee0 100644
--- a/report.qmd
+++ b/report.qmd
@@ -24,7 +24,11 @@ breaks: false
 
 # Abstract
 
-TODO
+*TODO*
+
+*NOTE TO EDITORS:
+TODO notes like this are annotations targeted authors and editors;
+they are **not** intended for inclusion in the final delivery.*
 
 # Introduction
 
@@ -83,21 +87,25 @@ under the Creative Commons crediting share-alike 4.0.
 
 # Project Planning
 
-TODO
+*TODO*
 
 # Analysis and Design
 
-TODO
+*TODO*
 
 # Description of the Program
 
-Use of the library in a sketch...
+The system consists of two parts,
+the sensor system on each mussel
+and the vote handling system...
+
+*TODO*
 
 ```{.plantuml}
-!include Mussel/examples/seconds/seconds.puml
+!include Mussel/components.puml
 ```
 
-TODO
+*TODO*
 
 ## Library function `begin()`
 
@@ -113,19 +121,25 @@ TODO
 
 # User Guide
 
-TODO
+Concrete use of the library in a sketch involves...
+*TODO*
+
+```{.plantuml}
+!include Mussel/examples/seconds/seconds.puml
+```
+*TODO*
 
 # Testing
 
-TODO
+*TODO*
 
 # Discussion
 
-TODO
+*TODO*
 
 # Conclusion
 
-TODO
+*TODO*
 
 # Bibliography {.appendix}