blob: 2e19b84c8e653405ef447fd4afbba9aa75a9bd9d (
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
|
# Introduction
- who is this manual for?
- what is Subplot meant for?
- who is Subplot meant for?
- history of Subplot
- public use cases of Subplot
# An overview of acceptance criteria and their verification
- discuss acceptance criteria vs requirements; functional vs
non-functional requirements; automated vs manual testing
- discuss stakeholders
- discuss different approaches for verifying that a system meets it
criteria
- discuss how scenarios can be used to verify acceptance criteria
# Simple example project
- discuss how to use Subplot for some simple, but not simplistic,
software project
- discuss different kinds of stakeholders a project may have
# Authoring Subplot documents
- discuss that it may be necessary to have several documents for
different audiences, at different levels of abstraction (cf. the
FOSDEM safety devroom talk)
- discuss writing style to target all the different stakeholders
- discuss mechanics and syntax
- Markdown and supported features
- scenarios, embedded files, examples
- bindings
- step implementations in various languages
- embedded markup for diagrams
- running docgen
# Extended example project
- discuss how to use Subplot for a significant project, but keep it
sufficiently high level that it doesn't get too long and tedious
to read
# Appendix: Implementing scenario steps in Bash
- this appendix will explain how to implement scenario steps using
the Bash shell
# Appendix: Implementing scenario steps in Python
- this appendix will explain how to implement scenario steps using
the Python language
# Appendix: Implementing scenario steps in Rust
- this appendix will explain how to implement scenario steps using
the Rust language
# Appendix: Scenario
This is currently necessary so that codegen won't barf.
~~~scenario
when I run /bin/true
~~~
|