Skip to content

Commit

Permalink
docs: Add a Design Doc blueprint.
Browse files Browse the repository at this point in the history
This should be the template for all new Design Docs, minor deviations aside.
Hopefully this makes the process a bit easier.
  • Loading branch information
PhilipMetzger committed Jun 27, 2024
1 parent 0ea2d4d commit 9f31439
Show file tree
Hide file tree
Showing 3 changed files with 51 additions and 0 deletions.
44 changes: 44 additions & 0 deletions docs/design_doc_blueprint.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# Title

> A cool name for your Project
Author: [Your-Name](mailto:[email protected])

> If there are multiple authors, just list them all
## Summary

A short summary of your project/re-design/component and what problems it
addresses in about 3-10 sentences.

## State of the Feature as of `$VERSION` (optional)

The state of the feature you want to improve and where it currently falls
short. If there's nothing to compare to, leave it out.

## Goals and non-goals

Direct goals of the project and features deemed not worth pursuing.

## Overview

A detailed overview of the project and the improvements it brings.

### Detailed Design

The place to describe all new interfaces and interactions and how it plays into
the existing code and behavior. This is the place for all nitty-gritty details
which interact with the system.

## Alternatives considered (optional)

Other alternatives to your suggested approach, and why they fall short.

### Issues addressed (optional)

A list of issues which are addressed by this design.

## Future Possibilities

The section for things which could be added to it or deemed out of scope during
the discussion.
6 changes: 6 additions & 0 deletions docs/design_docs.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,3 +20,9 @@ already familiar with the codebase, to not stall the implementation.


[Rust RFCs]: https://github.com/rust-lang/rfcs

## Blueprint (Template)

You can find the base template of a new Design Doc
[here](design_doc_blueprint.md).

1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -129,6 +129,7 @@ nav:
- 'Guidelines and "How to...?"': 'contributing.md'
- 'Code of conduct': 'code-of-conduct.md'
- 'Design Docs': 'design_docs.md'
- 'Design Doc Blueprint': 'design_doc_blueprint.md'

- 'Design docs':
- 'git-submodules': 'design/git-submodules.md'
Expand Down

0 comments on commit 9f31439

Please sign in to comment.