2011-03-18 02:15:25 +01:00
|
|
|
|
= Hacking on Net::LDAP
|
2010-03-25 04:16:58 +01:00
|
|
|
|
|
2010-04-19 07:03:52 +02:00
|
|
|
|
We welcome your contributions to Net::LDAP. We accept most contributions, but
|
|
|
|
|
|
there are ways to increase the chance of your patch being accepted quickly.
|
|
|
|
|
|
|
|
|
|
|
|
== Licensing
|
|
|
|
|
|
|
2011-03-18 02:37:17 +01:00
|
|
|
|
Net::LDAP 0.2 and later are be licensed under an MIT-style license; any
|
2010-04-19 07:03:52 +02:00
|
|
|
|
contributions after 2010-04-20 must be under this license to be accepted.
|
|
|
|
|
|
|
|
|
|
|
|
== Formatting
|
|
|
|
|
|
|
|
|
|
|
|
* Your patches should be formatted like the rest of Net::LDAP.
|
|
|
|
|
|
* We use a text wrap of 76–78 characters, especially for documentation
|
|
|
|
|
|
contents.
|
|
|
|
|
|
* Operators should have spaces around them.
|
|
|
|
|
|
* Method definitions should have parentheses around arguments (and no
|
|
|
|
|
|
parentheses if there are no arguments).
|
|
|
|
|
|
* Indentation should be kept as flat as possible; this may mean being more
|
|
|
|
|
|
explicit with constants.
|
|
|
|
|
|
|
2011-03-18 02:37:17 +01:00
|
|
|
|
|
2010-03-25 04:16:58 +01:00
|
|
|
|
We welcome your contributions to Net::LDAP. To increase the chances of your
|
|
|
|
|
|
patches being accepted, we recommend that you follow the guidelines below:
|
|
|
|
|
|
|
2010-04-19 07:03:52 +02:00
|
|
|
|
== Documentation
|
|
|
|
|
|
|
2011-03-18 02:37:17 +01:00
|
|
|
|
* Documentation: {net-ldap}[http://net-ldap.rubyforge.org/]
|
2010-04-19 07:03:52 +02:00
|
|
|
|
|
|
|
|
|
|
It is very important that, if you add new methods or objects, your code is
|
|
|
|
|
|
well-documented. The purpose of the changes should be clearly described so that
|
|
|
|
|
|
even if this is a feature we do not use, we can understand its purpose.
|
|
|
|
|
|
|
|
|
|
|
|
We also encourage documentation-only contributions that improve the
|
|
|
|
|
|
documentation of Net::LDAP.
|
|
|
|
|
|
|
2011-03-18 02:37:17 +01:00
|
|
|
|
We encourage you to provide a good summary of your as a modification to
|
|
|
|
|
|
+History.rdoc+, and if you're not yet named as a contributor, include a
|
|
|
|
|
|
modification to +Contributors.rdoc+ to add yourself.
|
|
|
|
|
|
|
2010-04-19 07:03:52 +02:00
|
|
|
|
== Tests
|
|
|
|
|
|
|
|
|
|
|
|
The Net::LDAP team uses RSpec for unit testing; all changes must have rspec
|
|
|
|
|
|
tests for any new or changed features.
|
|
|
|
|
|
|
|
|
|
|
|
Your changes should have been tested against at least one real LDAP server; the
|
|
|
|
|
|
current tests are not sufficient to find all possible bugs. It's unlikely that
|
|
|
|
|
|
they will ever be sufficient given the variations in LDAP server behaviour.
|
|
|
|
|
|
|
2011-03-18 02:37:17 +01:00
|
|
|
|
If you're introducing a new feature, it would be preferred for you to provide
|
|
|
|
|
|
us with a sample LDIF data file for importing into LDAP servers for testing.
|
2010-04-19 07:03:52 +02:00
|
|
|
|
|
|
|
|
|
|
== Development Dependencies
|
|
|
|
|
|
|
|
|
|
|
|
Net::LDAP uses several libraries during development, all of which can be
|
|
|
|
|
|
installed using RubyGems.
|
|
|
|
|
|
|
|
|
|
|
|
* *hoe*
|
|
|
|
|
|
* *hoe-git*
|
|
|
|
|
|
* *metaid*
|
2011-03-18 02:37:17 +01:00
|
|
|
|
* *rspec*
|
|
|
|
|
|
* *flexmock*
|
2010-04-19 07:03:52 +02:00
|
|
|
|
|
|
|
|
|
|
== Participation
|
|
|
|
|
|
|
2011-03-18 02:37:17 +01:00
|
|
|
|
* RubyForge: {net-ldap}[http://rubyforge.org/projects/net-ldap]
|
|
|
|
|
|
* GitHub: {ruby-ldap/ruby-net-ldap}[https://github.com/ruby-ldap/ruby-net-ldap/]
|
|
|
|
|
|
* Group: {ruby-ldap}[http://groups.google.com/group/ruby-ldap]
|
