diff --git a/docs/random/moving-plugins b/docs/random/moving-plugins index da76f5ecdd..6ac9daf5f3 100644 --- a/docs/random/moving-plugins +++ b/docs/random/moving-plugins @@ -1,7 +1,7 @@ Moving around plug-ins between source modules --------------------------------------------- -Last updated: 2005-11-18 +Last updated: 2006-09-01 How to get your plug-in out of -bad and into -good or -ugly ----------------------------------------------------------- @@ -10,16 +10,39 @@ Since GStreamer 0.9.x, we have four plugin modules: -base, -good, -ugly, and -bad. Plug-ins are by default added to -bad. They can only move to -good or -ugly if a number of conditions are met: +PEOPLE +------ - People involved: - There should be a person who is actively going to maintain this element; presumably this is the person writing the plug-in in the first place + and opening the move request - There should be a GStreamer hacker who is willing to sponsor the element; this would be someone who is going to help out getting all the conditions + met, act as a mentor if necessary,... + - There should be a core developer who verifies that the checklist is met - - There should be a core developer who verifies the merge The three roles can be filled by two people, but not just one. + In addition, an admin needs to perform the actual move, which involves + CVS surgery. + +PROCESS +------- +- bug in bugzilla gets filed by someone requesting a move from bad + to good/ugly + This is "requesting" the move. +- a second person reviews the request and code, and verifies that the + plugin meets the checklist items below, by commenting on he bug + and giving a rundown of what still needs to be done + This is "sponsoring" the move. +- when the checklist is met, a third person can approve the move. + This is "approving" the move. +- an admin performs the move. + This is "performing" the move. (Are you laughing yet ?) + +CHECKLIST +--------- - The plug-in's code: - should descend from an applicable base class if possible - make use of GST_BOILERPLATE macros