3. Developing User Stories
See also User Story template.
User Stories
As a OSHW User, I want to Build an OSHW Project, so that I can Reproduce the OSHW Project
related to 1. Core Capabilities: 1. OSHW Definition
notes
- build using alternative components for (end-of-life) availability
As a OSHW User, I want to Build an OSHW Project with Alternative Components, so that I can Address Issues with Component Availability
related to 1. Core Capabilities: 1. OSHW Definition
As a OSHW Developer, I want to Ensure Unique Project Element Names, so that I can Unambiguously Identify Every Instance of a Component in a Project
related to 1. Core Capabilities: 1. OSHW Definition
As a OSHW Developer, I want to Organize OSHW Project, so that I can Conform to DRY Principle
related to 1. Core Capabilities: 4. OSHW Development Should Leverage Modern Software Development Techniques
notes
- need for bridging knowledge gap between industry standard and open-source practices; no mentoring programs / methodology
- while the DOF team agrees this is a challenge within the OSHW community, it is outside the scope of DOF (packaging a OSHW project to be shareable/modifiable/reproducible)
- lintable data structure
- interpret "lintable" to mean the content in the model is verifiable (no missing fields, orphan elements, etc.)
- LinkML "validate" capability implements these kinds of tests
- a.k.a., expose ability to validate content
As a OSHW Developer, I want to Verify Project Data, so that I can Discover Project Errors Early
related to 1. Core Capabilities: 4. OSHW Development Should Leverage Modern Software Development Techniques
As a OSHW Developer, I want to Decompose OSHW Project into Subprojects, so that I can Identify Reusable Elements of a Project
related to 1. Core Capabilities: 4. OSHW Development Should Leverage Modern Software Development Techniques
As a OSHW Developer, I want to Reuse Elements of External OSHW Projects, so that I can Build upon Previous Engineering Effort
related to 1. Core Capabilities: 4. OSHW Development Should Leverage Modern Software Development Techniques
As a OSHW Developer, I want to Reuse Elements of This OSHW Project, so that I can Define an Element of a Project Only Once
related to 1. Core Capabilities: 4. OSHW Development Should Leverage Modern Software Development Techniques
As a OSHW User, I want to Fork an OSHW Project, so that I can Customize the Forked OSHW Project
related to 1. Core Capabilities: 3. OSHW Should Be like OSS
As a OSHW Developer, I want to Automate Certification, so that I can Easily Certify Every Release
related to 1. Core Capabilities: 2. OSHW Certification
As a OSHW Developer, I want to Diff a Project between Commits, so that I can Review Changes between Commits
related to 3. OSHW Should Be like OSS
As a OSHW User, I want to Annotate an OSHW Project, so that I can Provide Context or Explanation about Model Content
related to 1. Core Capabilities: 0. Unidentified
As a OSHW User, I want to Comment on Elements, so that I can Explain or Discuss Elements
related to 1. Core Capabilities: 0. Unidentified
As a OSHW Developer, I want to Attach a Citation to Elements, so that I can Attribute Credit to External Resources
related to 1. Core Capabilities: 0. Unidentified
As a OSHW User, I want to Create Agile Decision Record about Elements, so that I can Capture the Reasoning behind a Decision
related to 1. Core Capabilities: 0. Unidentified
As a OSHW Developer, I want to Associate a Figure with Elements, so that I can Describe the Element Visually
related to 1. Core Capabilities: 0. Unidentified
As a OSHW Developer, I want to Associate an Asset with Elements, so that I can Use Supporting Material
related to 1. Core Capabilities: 0. Unidentified
Users
notes
- user who builds OSHW projects for their own use
notes
- user who develops/maintains OSHW project(s)
Use Cases
List of actions to be performed by a user
Rationales
List of objectives/reasons
Children
Backlinks