LUMIERA.clone/doc/template/rfc.txt

73 lines
1.3 KiB
Text
Raw Normal View History

# 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