lumiera_/doc/devel/design_process.txt

47 lines
2.2 KiB
Text
Raw Permalink Normal View History

Design Process
==============
2012-10-07 08:06:30 +02:00
//Menu: include rfc
2012-09-18 02:31:44 +02:00
//Menu: include rfc_final
//Menu: include rfc_pending
2012-09-18 02:31:44 +02:00
//Menu: include rfc_parked
//Menu: include rfc_dropped
2012-09-18 02:31:44 +02:00
//Menu: put child 'rfc_dropped' after 'rfc_final'
2012-10-07 08:06:30 +02:00
//Menu: attach child 'rfc'
2012-09-18 02:31:44 +02:00
How it Works
------------
2011-04-14 19:22:04 +02:00
Design Process entries (Request for Comment) can be created by anyone.
Each entry goes through several stages until it's accepted (or rejected).
2012-09-18 02:31:44 +02:00
All our RfC entries are filed here, either in the link:rfc_final/index.html[RfC accepted] section,
or as link:rfc_pending/index.html[pending RfC] or as link:rfc_dropped/index.html[RfC dropped].
* Every proposal starts out as _*Idea*_, allowing other people to review and comment on it, while still working out details.
* When the _Idea_ is in a proper shape and worked out in most details it becomes a _*Draft*_.
This _Draft_ need to be carefully reviewed, commented, perhaps corrected and rated by the other Developers.
* We decide on some proposals to talk about that another time, these get a _*Parked*_ state.
* At some point we may decide that a _*Draft*_ becomes a _*Final*_.
Usually, this happens in our link:/devs-vault/meeting/index.html[monthly developers meetings].
* Sometimes proposals will become dropped for some reason, this is indicated by changing their state to _*Dropped*_,
they still stay in the system for further reference.
Generally you should refrain from editing someone others proposals (except for typo and grammar fixes)
when this is not acknowledged with the original author. Rather only add comments to the pages and please
care to sign your comments in order to make it easier to find out who is the contact person for some note.
What qualifies as an RfC proposal
---------------------------------
CAUTION: to be written
Handling of RfC entries in practice
-----------------------------------
.Adding a new Proposal:
. Check if there is no similar proposal below! If yes, contact it's author and contribute to that one.
. Think of a good/descriptive _Name-ID_ for the Proposal. It will be used to create a RfC sub-page, so no embedded spaces please.
2011-04-14 19:22:04 +02:00
. Use the './admin/rfc.sh' helper script to maintain the RFC's. Check out its link:../technical/infra/rfcsh.html[documentation].