-
Notifications
You must be signed in to change notification settings - Fork 11
Minutes 13 Mar 2025
Paul Albertella edited this page Mar 14, 2025
·
2 revisions
Host: Paul Albertella
Participants: Florian Wuehr, Pete Brink, Gabriele Paoloni, Stephen Oresanya, Igor Stoppa, Daniel Krippner
Agenda
- Updates on documents
- Trustable Software Framework
Discussion
Updates on documents
Pete shared set of criteria for document review (branch)
- Superset of criteria that we could apply
- Some of the document metadata may be superfluous if we are using git, but there can be value in e.g. document version numbering if we have a review workflow that is independent of the PR process
- Danger that documents can languish at a ‘draft’ level - would be useful to have a push towards making something useable
Gab: Would be useful to make the criteria specific for ELISA
Paul: Yes, idea is that we share the generic criteria and then specify which we apply for ELISA
Change control criteria should describe the objectives, rather than the mechanism
- Then we can describe how we achieve this for ELISA (using GitHub)
Reviewer competencies
- Daniel: As an open source project, shouldn’t we allow anybody to provide feedback?
- Pete: Yes, but how do we determine whether it is valid?
- Daniel: We can use a project-managed set of ‘approved’ reviewers
- Igor: Implies a ‘trust’ component in the review. Better criteria would be to have appeal to ‘indisputable facts’.
- Pete: There are problems of relevance or scope, even if facts are well established
- Author(s) should have final say about scope; maintainer(s) should have the final say over what is merged
- Some method of conflict resolution should be included, but we don’t necessarily have to have a procedure for that
- Could have a ‘disputed’ section that is highlighted
- Pete: We can also use categorisation of feedback / violations to help with this:
- e.g. Critical, Severe, Minor, Question
- Exit conditions: When are we ready to proceed? Where proceed might be ‘publish as draft’ or ‘request for comment’.
Next steps: Review thes in Pull request
- Paul: Might also be worth looking at the RFC process to see if it has anything useful we can re-use
Trustable Software Framework
Paul talked about how to apply the TSF in practice, using examples from the Safety Monitor project.
- Examples of Statements that are linked to TA, to:
- explain (part of) how the project satisfies one or more of of the TA (Assertions)
- provide evidence to support this, by referencing an artifact (e.g. file in the repo or result from a CI job)
- Nice example of how the project is addressing one of the TA
- Using the rust's cargo-deny to verify that a dependency is still actively maintained
- Daniel K: Using similar techniques with rust in this project