README.md in twitter-4.4.0 vs README.md in twitter-4.4.1
- old
+ new
@@ -369,11 +369,11 @@
Here are some fun facts about this library:
* It is implemented in just 2,000 lines of Ruby code
* With over 4,000 lines of specs, the spec-to-code ratio is over 2:1
-* The spec suite contains 700 examples and runs in about 2 seconds
+* The spec suite contains over 700 examples and runs in about 5 seconds
* It has 100% C0 code coverage (the tests execute every line of
source code at least once)
* It is comprehensive: you can request all documented Twitter REST API
resources (over 100 resources)
* This gem works on every major Ruby implementation, including JRuby and
@@ -402,9 +402,25 @@
volunteer to be a maintainer. Being a maintainer entails making sure all tests
run and pass on that implementation. When something breaks on your
implementation, you will be personally responsible for providing patches in a
timely fashion. If critical issues for a particular implementation exist at the
time of a major release, support for that Ruby version may be dropped.
+
+## Versioning
+
+This library aims to adhere to [Semantic Versioning 2.0.0][semver]. Violations
+of this scheme should be reported as bugs. Specifically, if a minor or patch
+version is released that breaks backward compatibility, that version should be
+immediately yanked and/or a new version should be immediately released that
+restores compatibility. Breaking changes to the public API will only be
+introduced with new major versions. As a result of this policy, you can (and
+should) specify a dependency on this gem using the [Pessimistic Version
+Constraint][pvc] with two digits of precision. For example:
+
+ spec.add_dependency 'twitter', '~> 4.0'
+
+[semver]: http://semver.org/
+[pvc]: http://docs.rubygems.org/read/chapter/16#page74
## Additional Notes
This will be the last major version of this library to support Ruby 1.8.
Requiring Ruby 1.9 will allow us to [remove][class_variable_get]
[various][each_with_object] [hacks][singleton_class] put in place to maintain