2.2 KiB
Meta RFC for dev team
tags :: work organisation source ::
Yesterday in our weekly meeting I discussed about how I would like us to work with RFCs.
I would like to add this document to talk about RFCs. So this is a meta document. I hope not to trigger the need for a meta-meta-document ;). I will try to keep it self-referencing by using its own
Problem
We do not have proper RFC template. Developer focused RFCs and Feature specification RFC should probably have distinct templates.
Proposed Solutions
Here are my proposed templates.
We already have a dev
label we should probably use for RFC meaningful
only for developpers, and we should continu to use the Epic
label for
issues whose goal is the provide a spcecification document that we could
give to Managers with an Execution Plan.
Template Dev
This is the template I think we should use for everything regarding:
- coding conventions
- code tools
- code refactorisations
- code architecture
- code cleaning
[Title] <- name of the issue in github
Abstract: A little bit more than in the title
Audience: (Who's impacted?)
- iroh team
- ops
- ui team
- managers
- customers
RFC kind:
-
code convention (=> Audience => iroh-team only)
- ns naming convention
- position of args
- naming of args
- etc..
-
dev tooling (=> Audience => iroh-team, maybe ops)
- emacs mode
- cider
- clj-refactor
- CI
- scripts
- git commit message
- docker
- etc…
-
technical specification ( not Audience constraint )
- goal write a document for other dev (potential other teams), managers, and provide an execution plan
Objective
Select one or many of those and for each item write a description.
- Solve a problem.
- Provide a new feature,
- Improve the current situation.
Proposed Solutions
Solution 1
- describe one possible solution
- pros
- cons
Solution 2
- describe another possible solution
- pros
- cons
Consideration
- Security consideration