14 Spec Template

Clint Rutkas edited this page 2020-12-07 14:18:20 -08:00

Table of Contents

• DRAFT
• Name of feature
• 1: Overview
• 1.1: Executive overview (max 150 words)
• 1.2: Core Scenarios
• 1.3: Existing solutions and expectations
• 1.3.X: Name
• 1.4: Goals/Non-goals
• 1.4.1: Goals
• 1.4.2: Non-goals
• 2: Scenarios
• 2.1: Golden path
• 2.X: Additional paths / scenarios (2.2 to 2.x)
• 3: Comms
• 3.1: Press release
• 3.2: Elevator pitch
• 3.3 Tweet (280 char)
• 4: Key definitions
• 5: Requirements
• 5.1: Core requirements
• 5.2: Settings requirements
• 5.3: Accessibility
• 5.4: Security
• 5.x: additional detail (5.5 to 5.x)
• 6: Functional design
• 6.1: Core design and screenshots
• 6.x: additional detail (6.2 to 6.x)
• 7: Measurements
• 8: Future considerations
• 9. Appendix

DRAFT

Name of feature

• What is it: quick TLDR
• Authors: who wrote it
• Spec Status: Draft|In Review|Final

1: Overview

1.1: Executive overview (max 150 words)

TEXT

1.2: Core Scenarios

• Item

1.3: Existing solutions and expectations

1.3.X: Name

Include positives about the existing solution and things that we should be aware for a positive experience inside PowerToys

1.4: Goals/Non-goals

1.4.1: Goals

• Item

1.4.2: Non-goals

• Item

2: Scenarios

2.1: Golden path

TEXT

2.X: Additional paths / scenarios (2.2 to 2.x)

TEXT

3: Comms

3.1: Press release

TEXT

3.2: Elevator pitch

TEXT

3.3 Tweet (280 char)

TEXT

4: Key definitions

Term	Definition

5: Requirements

5.1: Core requirements

#	Definition	Priority
1	TEXT	P0
2

5.2: Settings requirements

#	Definition	Priority
1	TEXT	P0
2

5.3: Accessibility

#	Definition	Priority
1	TEXT	P0
2

5.4: Security

#	Definition	Priority
1	TEXT	P0
2

5.x: additional detail (5.5 to 5.x)

#	Definition	Pri
1	TEXT	P0
2

6: Functional design

6.1: Core design and screenshots

TEXT + imgs

6.x: additional detail (6.2 to 6.x)

TEXT + imgs

7: Measurements

#	Requirement	Implication	Pri
1	TEXT	TEXT	P0
1

8: Future considerations

TEXT

9. Appendix

Shipped utilities

• Awake
• Color Picker
• FancyZones
• File Explorer Add-ons
• Image Resizer
• Keyboard Manager
• PowerRename
• PowerToys Run
• Shortcut Guide
• Video Conference Mute

Help

• App Compatibility
• Running PowerToys elevated

Installer

• EXE args

Roadmap

• Roadmap
• Stable strategy
• Versioning (draft)

Planning

• Specs

System knowledge

• Triage
• Release check list
• Organization
• Dev Docs