Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Proposal: Connect Work Items to Use Cases via Requirements #1110

Open
mmccool opened this issue Jul 24, 2023 · 1 comment
Open

Proposal: Connect Work Items to Use Cases via Requirements #1110

mmccool opened this issue Jul 24, 2023 · 1 comment

Comments

@mmccool
Copy link
Contributor

mmccool commented Jul 24, 2023

As discussed in Discovery and Security TFs:

  • We need to motivate work items with use cases
  • Probably best to do requirements as an intermediate step so that requirements from multiple use cases can be consolidated
  • Discovery already has an (old, but still valid) list of requirements: https://github.com/w3c/wot-usecases/blob/main/REQUIREMENTS/discovery.md
  • Suggest merging this into the Discovery section under "Requirements" in the Use Cases document, updating, and then linking each requirement to one or more use cases that motivate it, then link work items to the requirements it satisfies.
  • Each requirement should be given an id, so it can be linked
  • Each work item should then link to the requirement it satisfies

Note: We may have to add some "general" requirements like "Ease of Use", etc. for some work items.

We would do something similar for security, but in this case the "Requirements" would be the Threat the security "feature" would mitigate. Threats are all listed in the security and privacy guidelines document (some need to be updated), but each Security section has a risk followed by a mitigation, so connecting these should be straightforward. Details however can be listed in the S&PG doc, the UC&R doc can just use the titles.

@mmccool
Copy link
Contributor Author

mmccool commented Jul 24, 2023

See also w3c/wot-usecases#103, still open, and maybe w3c/wot-usecases#40

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant