- File www/contribute.wiki — part of check-in [192aebcb1d] at 2015-02-09 21:20:00 on branch httpsLinks — Change links to HTTPS, where applicable. (user: mistachkin size: 3691) [more...]
Contributing To System.Data.SQLite
Users are encouraged to contributed enhancements back to the System.Data.SQLite project. This note outlines some of the procedures for making useful contributions.
1.0 Contributor Agreement
In order to accept your contributions, we must have a Contributor Agreement on file for you. We require this in order to maintain clear title to the System.Data.SQLite code and prevent the introduction of code with incompatible licenses or other entanglements that might cause legal problems for System.Data.SQLite users.
If you do not wish to submit a Contributor Agreement, we would still welcome your suggestions and example code, but we will not use your code directly - we will be forced to reimplement your changes from scratch which might take longer.
2.0 Submitting Patches
Suggested changes or bug fixes can be submitted by creating a patch against the current source tree. Email patches to firstname.lastname@example.org. Be sure to describe in detail what the patch does and which version of System.Data.SQLite it is written against.
A contributor agreement is not strictly necessary to submit a patch. However, without a contributor agreement on file, your patch will be used for reference only - it will not be applied to the code. This may delay acceptance of your patch.
Your patches or changes might not be accepted even if you do have a contributor agreement on file. Please do not take this personally or as an affront to your coding ability. Sometimes patches are rejected because they seem to be taking the project in a direction that the architect does not want to go. Or, there might be an alternative implementation of the same feature being prepared separately.
3.0 Check-in Privileges
Check-in privileges are granted on a case-by-case basis. Your chances of getting check-in privileges are much improved if you have a history of submitting quality patches and/or making thoughtful posts on the mailing list. A contributor agreement is, of course, a prerequisite for check-in privileges.
Contributors are asked to make all non-trivial changes on a branch. A System.Data.SQLite admin will review the branch and merge the changes into the trunk.
Contributors are required to following the pre-checkin checklist prior to every checkin to the System.Data.SQLite self-hosting repository. This checklist is short and succinct and should only require a few seconds to follow. Contributors should print out a copy of the pre-checkin checklist and keep it on a notecard beside their workstations, for quick reference.
Contributors should review and try to mimic the coding style used through the rest of the System.Data.SQLite source code. Your code should blend in. A third-party reader should be unable to distinguish your code from any other code in the source corpus.
Furthermore, all new code must contain "documentation comments" that can be successfully processed up by the Microsoft C# compiler.
System.Data.SQLite has several automated test suites that excercise its base functionality, but this is an area that needs further work. (Your contributions here are welcomed!) Contributors with check-in privileges are expected to run the test suites on all changes they contribute, and if appropriate add new automated test scripts to cover their additions.