Nikos Balkanas schrieb: > Hi, > > I see a lot of patches going around on this group. I would like to > propose not to accept patches unless the relevant points are updated in > the documentation. Furthermore I suggest that this should be a > distributed effort by each submitter. Too much I think has fallen on the > shoulders of Alex trying to verify the code, to be able to maintain the > documentation as well. Of course that would mean that documentation > needs to get in the CVS if not already there. And definitely this > applies only to new features/improvements, not to bug fixes. > > This should facilitate also traffic in the group, inasmuch new users, > like me, ask, over and over again, a lot of questions that are either > outdated or nonexistent in the manual. A searchable mail list would be > an improvement but could not substitute for a current manual. > > Any comments?
agreed. We have those 'formal guidelines' for [PATCH] submission, but I guess it wouldn't hurt to setup a simple .html page on the web site to make them more universal available. Main policy items, IMO: 1. where to submit: devel@ list. 2. subject prefixing: [PATCH] my foobar patch that does 3. form of the patch: diff -u against CVS HEAD at 'gateway' root 4. form of source code: gateway/doc/CodingStyle should be obeyed 5. explanation of the patch: the more the reviewers "understand" the easier to review, and then vote. This enhances the patch post to commit cycle 6. all 'open' patches should be maintained in mantis (bug tracking system) too, at least as reference (i.e. via the mailing list Msg-Id) and the patch itself attachment. This helps us to maintain a single point of view to see what pathces are still pending. 7. any patch that introduces a behavior change needs votes, hence consensus of the group. 8. obvious bug fixes can be committed directly, but should be noticeable to the devel@ list with the same subject prefixing. any more? or comments on these? Stipe -- ------------------------------------------------------------------- Kölner Landstrasse 419 40589 Düsseldorf, NRW, Germany tolj.org system architecture Kannel Software Foundation (KSF) http://www.tolj.org/ http://www.kannel.org/ mailto:st_{at}_tolj.org mailto:stolj_{at}_kannel.org -------------------------------------------------------------------
