2020-11-26 10:00:03 +00:00
|
|
|
#+TITLE: [Meta RFC] RFC template
|
2020-11-26 09:12:29 +00:00
|
|
|
#+Author: Yann Esposito
|
|
|
|
#+Date: [2020-11-26]
|
|
|
|
|
2020-11-26 09:15:10 +00:00
|
|
|
tags :: [[file:../../../../../../.org/journal/2020-11-26--10-12-21Z--work.org][work]] [[file:../../../../../../.org/journal/2020-11-26--10-12-42Z--organisation.org][organisation]]
|
2020-11-26 09:12:29 +00:00
|
|
|
source ::
|
2020-11-26 09:15:10 +00:00
|
|
|
|
2020-11-26 10:00:03 +00:00
|
|
|
/Abstract/: Yesterday in our weekly meeting I discussed about how I would
|
|
|
|
like us to work with RFCs.
|
2020-11-26 09:58:23 +00:00
|
|
|
I would like to add this document to talk about RFCs.
|
2020-11-26 09:15:10 +00:00
|
|
|
So this is a meta document.
|
|
|
|
I hope not to trigger the need for a meta-meta-document ;).
|
2020-11-26 10:00:03 +00:00
|
|
|
I will try to keep it self-referencing by using its own description.
|
|
|
|
Closer to the quine :).
|
|
|
|
|
|
|
|
*Audience*: (Who's impacted?)
|
|
|
|
+ iroh team
|
|
|
|
+ managers
|
|
|
|
|
|
|
|
*RFC kind*:
|
|
|
|
+ team organisation
|
|
|
|
|
|
|
|
** 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
|
2020-11-26 09:15:10 +00:00
|
|
|
|
2020-11-26 09:16:12 +00:00
|
|
|
* Problem
|
|
|
|
|
2020-11-26 09:29:43 +00:00
|
|
|
We do not have proper RFC template.
|
|
|
|
Developer focused RFCs and Feature specification RFC should probably have distinct templates.
|
2020-11-26 09:26:26 +00:00
|
|
|
|
2020-11-26 09:29:43 +00:00
|
|
|
* Proposed Solutions
|
2020-11-26 09:27:49 +00:00
|
|
|
|
2020-11-26 09:29:43 +00:00
|
|
|
Here are my proposed templates.
|
2020-11-26 09:31:07 +00:00
|
|
|
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.
|
2020-11-26 09:21:41 +00:00
|
|
|
|
2020-11-26 09:29:43 +00:00
|
|
|
** Template Dev
|
2020-11-26 09:32:47 +00:00
|
|
|
|
2020-11-26 09:56:18 +00:00
|
|
|
*** [Title] <- name of the issue in github
|
2020-11-26 09:33:55 +00:00
|
|
|
|
2020-11-26 09:56:18 +00:00
|
|
|
/Abstract/: A little bit more than in the title
|
2020-11-26 09:36:24 +00:00
|
|
|
|
2020-11-26 09:56:18 +00:00
|
|
|
*Audience*: (Who's impacted?)
|
2020-11-26 09:51:51 +00:00
|
|
|
+ iroh team
|
|
|
|
+ ops
|
|
|
|
+ ui team
|
|
|
|
+ managers
|
|
|
|
+ customers
|
|
|
|
|
2020-11-26 09:56:18 +00:00
|
|
|
*RFC kind*:
|
2020-11-26 10:01:23 +00:00
|
|
|
+ code convention (=> Audience; iroh-team only)
|
2020-11-26 09:42:56 +00:00
|
|
|
- ns naming convention
|
|
|
|
- position of args
|
|
|
|
- naming of args
|
|
|
|
- etc..
|
2020-11-26 10:01:23 +00:00
|
|
|
+ dev tooling (=> Audience; iroh-team, maybe ops)
|
2020-11-26 09:42:56 +00:00
|
|
|
- emacs mode
|
|
|
|
- cider
|
|
|
|
- clj-refactor
|
|
|
|
- CI
|
|
|
|
- scripts
|
|
|
|
- git commit message
|
|
|
|
- docker
|
|
|
|
- etc...
|
2020-11-26 10:01:23 +00:00
|
|
|
+ team organisation (=> Audience; iroh-team, managers)
|
2020-11-26 09:55:15 +00:00
|
|
|
+ technical specification ( not Audience constraint )
|
2020-11-26 09:43:59 +00:00
|
|
|
- goal write a document for other dev (potential other teams), managers, and provide an execution plan
|
2020-11-26 09:33:55 +00:00
|
|
|
|
2020-11-26 09:56:18 +00:00
|
|
|
**** Objective
|
2020-11-26 09:36:24 +00:00
|
|
|
|
2020-11-26 09:49:40 +00:00
|
|
|
Select one or many of those and for each item write a description.
|
|
|
|
|
|
|
|
- Solve a problem.
|
|
|
|
- Provide a new feature,
|
|
|
|
- Improve the current situation.
|
|
|
|
|
2020-11-26 09:58:23 +00:00
|
|
|
**** Proposed Solutions
|
2020-11-26 09:49:40 +00:00
|
|
|
|
2020-11-26 09:58:23 +00:00
|
|
|
***** Solution 1
|
2020-11-26 09:50:47 +00:00
|
|
|
|
|
|
|
+ describe one possible solution
|
|
|
|
+ pros
|
|
|
|
+ cons
|
|
|
|
|
2020-11-26 09:58:23 +00:00
|
|
|
***** Solution 2
|
2020-11-26 09:50:47 +00:00
|
|
|
|
|
|
|
+ describe another possible solution
|
|
|
|
+ pros
|
|
|
|
+ cons
|
2020-11-26 09:33:55 +00:00
|
|
|
|
2020-11-26 09:58:23 +00:00
|
|
|
**** Consideration
|
2020-11-26 09:51:51 +00:00
|
|
|
|
|
|
|
+ Security consideration
|
2020-11-26 09:58:23 +00:00
|
|
|
+
|