added versioning policy notes

This commit is contained in:
HoneyryderChuck 2022-02-11 18:00:37 +00:00
parent eda4ad5bc3
commit 8436648b64

View File

@ -140,11 +140,15 @@ In order to use HTTP/2 under JRuby, [check this link](https://gitlab.com/honeyry
* Doesn't work with ruby 2.4.0 for Windows (see [#36](https://gitlab.com/honeyryderchuck/httpx/issues/36)). * Doesn't work with ruby 2.4.0 for Windows (see [#36](https://gitlab.com/honeyryderchuck/httpx/issues/36)).
* Using `total_timeout` along with the `:persistent` plugin [does not work as you might expect](https://gitlab.com/honeyryderchuck/httpx/-/wikis/Timeouts#total_timeout). * Using `total_timeout` along with the `:persistent` plugin [does not work as you might expect](https://gitlab.com/honeyryderchuck/httpx/-/wikis/Timeouts#total_timeout).
## Versioning Policy
Although 0.x software, `httpx` is considered API-stable and production-ready, i.e. current API or options may be subject to deprecation and emit log warnings, but can only effectively be removed in a major version change.
## Contributing ## Contributing
* Discuss your contribution in an issue * Discuss your contribution in an issue
* Fork it * Fork it
* Make your changes, add some tests * Make your changes, add some tests
* Ensure all tests pass (`bundle exec rake test`) * Ensure all tests pass (`docker-compose -f docker-compose.yml -f docker-compose-ruby-{RUBY_VERSION}.yml run httpx bundle exec rake test`)
* Open a Merge Request (that's Pull Request in Github-ish) * Open a Merge Request (that's Pull Request in Github-ish)
* Wait for feedback * Wait for feedback