From 7295b9178c48eea1a09c3d9cce221ad0db9f93c1 Mon Sep 17 00:00:00 2001 From: Zachary Scott Date: Tue, 16 Aug 2016 23:57:18 +0900 Subject: Clean up README and CONTRIBURING :nail_care: --- CONTRIBUTING.md | 53 ++++++++++++++++++++++++++++++++--------------------- 1 file changed, 32 insertions(+), 21 deletions(-) (limited to 'CONTRIBUTING.md') diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index a903b5e2..d230bda1 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,34 +1,38 @@ # Contributing to Ruby OpenSSL -Thank you for your interest in contributing to Ruby OpenSSL! This documentation -provides an overview how to contribute. +Thank you for your interest in contributing to Ruby OpenSSL! + +This documentation provides an overview how you can contribute. ## Bugs and feature requests Bugs and feature requests are tracked on [GitHub]. If you think you found a bug, file a ticket on GitHub. Please DO NOT report -security issue here, there is a separate procedure. +security issues here, there is a separate procedure which is described on +["Security at ruby-lang.org"](https://www.ruby-lang.org/en/security/). When reporting a bug, please make sure you include the version of Ruby, the -version of openssl gem, the version of OpenSSL, and a sample file that -illustrates the problem, link to the repository or gem that is associated with -the bug. +version of openssl gem, the version of the OpenSSL library, along with a sample +file that illustrates the problem or link to repository or gem that is +associated with the bug. There is a number of unresolved issues and feature requests for openssl that need review. Before submitting a new ticket, it is recommended to check -[known issues] and [bugs.ruby-lang.org], the former issue tracker. +[known issues] and [bugs.ruby-lang.org], the previous issue tracker. ## Submitting patches Patches are also very welcome! -Please submit a pull request with your changes. Make sure that your branch does: +Please submit a [pull request] with your changes. + +Make sure that your branch does: * Have good commit messages * Follow Ruby's coding style ([DeveloperHowTo]) -* Pass the test suite successfully -* Add an entry to NEWS if necessary +* Pass the test suite successfully (see "Testing") +* Add an entry to [History.rdoc] if necessary ## Testing @@ -40,14 +44,14 @@ $ rake compile $ rake test ``` -Test cases are located under test/ directory. +Test cases are located under `test/` directory. ## Relation with Ruby source tree -After Ruby 2.3, ext/openssl was converted into a "default gem", a library ships -with standard Ruby builds but can be upgraded via RubyGems. This means the -development of openssl has been migrated to a separate repository (this!) and -will be released independently. +After Ruby 2.3, `ext/openssl` was converted into a "default gem", a library +which ships with standard Ruby builds but can be upgraded via RubyGems. This +means the development of this gem has migrated to a [separate +repository][GitHub] and will be released independently. The version included in the Ruby source tree (trunk branch) is synchronized with the latest release. @@ -55,22 +59,29 @@ the latest release. ## Release policy Bug fixes (including security fixes) will be made only for the version series -included in a Ruby release. +included in a stable Ruby release. ## Security -If you feel you discovered a security issue, please send us in private, using -the security issue handling procedure for Ruby core. You can either use -[HackerOne] or send an email to security@ruby-lang.org. Please see [Security] -page on ruby-lang.org website for details. Reported problems will be published -after fixes. +If you discovered a security issue, please send us in private, using the +security issue handling procedure for Ruby core. + +You can either use [HackerOne] or send an email to security@ruby-lang.org. + +Please see [Security] page on ruby-lang.org website for details. + +Reported problems will be published after a fix is released. Thank you for your contributions! +- The Ruby OpenSSL Team + [GitHub]: https://github.com/ruby/openssl [known issues]: https://github.com/ruby/openssl/issues [bugs.ruby-lang.org]: https://bugs.ruby-lang.org/issues?utf8=%E2%9C%93&set_filter=1&f%5B%5D=status_id&op%5Bstatus_id%5D=o&f%5B%5D=assigned_to_id&op%5Bassigned_to_id%5D=%3D&v%5Bassigned_to_id%5D%5B%5D=7150&f%5B%5D=&c%5B%5D=project&c%5B%5D=tracker&c%5B%5D=status&c%5B%5D=subject&c%5B%5D=assigned_to&c%5B%5D=updated_on&group_by=&t%5B%5D= [DeveloperHowTo]: https://bugs.ruby-lang.org/projects/ruby/wiki/DeveloperHowto [HackerOne]: https://hackerone.com/ruby [Security]: https://www.ruby-lang.org/en/security/ +[pull request]: https://github.com/ruby/openssl/compare +[History.rdoc]: https://github.com/ruby/openssl/tree/master/History.rdoc -- cgit v1.2.3