Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(381)

Side by Side Diff: recipe_engine/third_party/requests/docs/dev/philosophy.rst

Issue 2164713003: Vendor requests. (Closed) Base URL: https://chromium.googlesource.com/external/github.com/luci/recipes-py@master
Patch Set: Fix deps.pyl Created 4 years, 5 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
OLDNEW
(Empty)
1 Development Philosophy
2 ======================
3
4 Requests is an open but opinionated library, created by an open but opinionated developer.
5
6
7 Management Style
8 ~~~~~~~~~~~~~~~~
9
10 `Kenneth Reitz <http://kennethreitz.org>`_ is the BDFL. He has final say in any decision related to the Requests project. Kenneth is responsible for the directi on and form of the library. In addition to making decisions based on technical m erit, he is responsible for making decisions based on the development philosophy of Requests. Only Kenneth may merge code into Requests.
11
12 `Ian Cordasco <http://www.coglib.com/~icordasc/>`_ and `Cory Benfield <https://l ukasa.co.uk/about/>`_ are the core contributors. They are responsible for triagi ng bug reports, reviewing pull requests and ensuring that Kenneth is kept up to speed with developments around the library. The day-to-day managing of the proje ct is done by the core contributors. They are responsible for making judgements about whether or not a feature request is likely to be accepted by Kenneth. They do not have the authority to change code or merge code changes, though they may change documentation. Their word is not final.
13
14 Values
15 ~~~~~~
16
17 - Simplicity is always better than functionality.
18 - Listen to everyone, then disregard it.
19 - The API is all that matters. Everything else is secondary.
20 - Fit the 90% use-case. Ignore the nay-sayers.
21
22 Semantic Versioning
23 ~~~~~~~~~~~~~~~~~~~
24
25 For many years, the open source community has been plagued with version number d ystonia. Numbers vary so greatly from project to project, they are practically m eaningless.
26
27 Requests uses `Semantic Versioning <http://semver.org>`_. This specification see ks to put an end to this madness with a small set of practical guidelines for yo u and your colleagues to use in your next project.
28
29 Standard Library?
30 ~~~~~~~~~~~~~~~~~
31
32 Requests has no *active* plans to be included in the standard library. This deci sion has been discussed at length with Guido as well as numerous core developers .
33
34 Essentially, the standard library is where a library goes to die. It is appropri ate for a module to be included when active development is no longer necessary.
35
36 Linux Distro Packages
37 ~~~~~~~~~~~~~~~~~~~~~
38
39 Distributions have been made for many Linux repositories, including: Ubuntu, Deb ian, RHEL, and Arch.
40
41 These distributions are sometimes divergent forks, or are otherwise not kept up- to-date with the latest code and bugfixes. PyPI (and its mirrors) and GitHub are the official distribution sources; alternatives are not supported by the Reques ts project.
OLDNEW
« no previous file with comments | « recipe_engine/third_party/requests/docs/dev/contributing.rst ('k') | recipe_engine/third_party/requests/docs/dev/todo.rst » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698