1================================================================================
2Submitting contributions
3================================================================================
4
5A lot of time has been put into designing, implementing and documenting this extension.
6
7A lot of work has also been put into ensuring that users of the extension
8experience very minimal defects during usage.
9
10New ideas, corrections, bug fixes, feature improvements are always welcome.
11
12However, you must discuss any changes you are about to make to any of
13the source files prior to making or submitting such changes either in the
14PECL developers mailing list (pecl-dev@lists.php.net) or by contacting the
15current author(s) or maintainer(s) of this extension directly.
16
17Test scripts should be included when making the submissions.
18
19Also explain thoroughly what has been fixed/added/changed by your patch.
20
21If your patch is easy to review and has obviously no side-effects,
22it might take up to a few hours until it is committed.
23
24Since this is a volunteer-driven effort, more complex patches will
25require more patience on the part of the submitter.
26
27================================================================================
28Testing thoroughly before submissions
29================================================================================
30
31This is a fairly large library and each component is dependent on another
32component either directly or indirectly.
33
34As a consequence, any and all changes must be tested thoroughly before commiting them.
35
36It is only polite to the users, author(s) or maintainer(s) that you do so.
37
38================================================================================
39Checklist for making submissions
40================================================================================
41
42 - Did you run "make test" to check if your patch didn't break
43   other features?
44 - Did you compile PHP with --enable-debug and check the PHP and
45   web server error logs when you test your patch?
46 - Did you build PHP for multi-threaded web servers.
47 - Did you create test script for "make test"? (Recommended)
48 - Did you check your patch is unified format and it does not
49   contain white space changes?
50 - Did you read the patch again?
51