64ad648eac
* new directory structure in doc/devel to take RFC's rfc/ - Final RFC's rfc_pending/ - Emerging RFC's rfc_dropped/ - Rejected or Parked RFC's * Template directory doc/template/ for just a rfc.txt for creating new RFC's yet * admin/rfc.sh a script to maintain RFC's
72 lines
1.3 KiB
Text
72 lines
1.3 KiB
Text
# this template is source by a shell script, caveat ` characters need to be escaped
|
|
cat <<EOF
|
|
$TITLE
|
|
${TITLE//?/=}
|
|
|
|
// please don't remove the //word: comments
|
|
|
|
[grid="all"]
|
|
\`------------\`-----------------------
|
|
*State* _Idea_
|
|
*Date* _$(date +%c)_
|
|
*Proposed by* $(git config --get user.name) <$(git config --get user.email)>
|
|
-------------------------------------
|
|
|
|
[abstract]
|
|
******************************************************************************
|
|
|
|
******************************************************************************
|
|
|
|
|
|
Description
|
|
-----------
|
|
//description: add a detailed description:
|
|
|
|
|
|
|
|
Tasks
|
|
~~~~~
|
|
// List what would need to be done to implement this Proposal in a few words:
|
|
// * item ...
|
|
|
|
|
|
Pros
|
|
^^^^
|
|
// add just a fact list/enumeration which make this suitable:
|
|
// * foo
|
|
// * bar ...
|
|
|
|
|
|
|
|
Cons
|
|
^^^^
|
|
// fact list of the known/considered bad implications:
|
|
|
|
|
|
|
|
Alternatives
|
|
------------
|
|
//alternatives: if possible explain/link alternatives and tell why they are not viable:
|
|
|
|
|
|
|
|
Rationale
|
|
---------
|
|
//rationale: Describe why it should be done *this* way:
|
|
|
|
|
|
|
|
//Conclusion
|
|
//----------
|
|
//conclusion: When approbate (this proposal becomes a Final) write some conclusions about its process:
|
|
|
|
|
|
|
|
|
|
Comments
|
|
--------
|
|
//comments: append below
|
|
|
|
|
|
//endof_comments:
|
|
EOF
|