microsoft / microsoft/devsquad-copilot
[specify] Encourage diagrams in specs
Open
Nobody has claimed this yet.
enhancement
- Dominant language
- No language data
- Stars
- 44
- Forks
- 10
- Avg merge
- 6h 49m
- Merged PRs (30d)
- 1
Description
Diagrams improve the clarity of feature specs. Guide the specify flow to include diagrams where they add value.
Acceptance criteria
- Spec guidance recommends diagrams (for example Mermaid) for flows, data models, and architecture.
- Ties into the existing diagram-design skill.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Locate the specify flow and the existing diagram-design skill, then read how current spec guidance is organized. Update the guidance to recommend diagrams such as Mermaid for flows, data models, and architecture, and confirm it ties into the diagram-design skill.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Feature
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 65/100