diff --git a/.github/CONTRIBUTING.rst b/.github/CONTRIBUTING.rst index 509fe6040..7e8aeef35 100644 --- a/.github/CONTRIBUTING.rst +++ b/.github/CONTRIBUTING.rst @@ -155,7 +155,7 @@ However, you’ll probably want a more traditional environment as well. We highly recommend to develop using the latest Python 3 release because ``attrs`` tries to take advantage of modern features whenever possible. First create a `virtual environment `_. -It’s out of scope for this document to list all the ways to manage virtual environments in Python, but if you don’t already have a pet way, take some time to look at tools like `pew `_, `virtualfish `_, and `virtualenvwrapper `_. +It’s out of scope for this document to list all the ways to manage virtual environments in Python, but if you don’t already have a pet way, take some time to look at tools like `pew `_, `virtualfish `_, and `virtualenvwrapper `_. Next, get an up to date checkout of the ``attrs`` repository: diff --git a/README.rst b/README.rst index e54255781..db287f73b 100644 --- a/README.rst +++ b/README.rst @@ -95,7 +95,7 @@ Testimonials Writing a fully-functional class using attrs takes me less time than writing this testimonial. -**Glyph Lefkowitz**, creator of `Twisted `_, `Automat `_, and other open source software, in `The One Python Library Everyone Needs `_: +**Glyph Lefkowitz**, creator of `Twisted `_, `Automat `_, and other open source software, in `The One Python Library Everyone Needs `_: I’m looking forward to is being able to program in Python-with-attrs everywhere. It exerts a subtle, but positive, design influence in all the codebases I’ve see it used in. diff --git a/docs/examples.rst b/docs/examples.rst index 656d969f3..c8b3381b3 100644 --- a/docs/examples.rst +++ b/docs/examples.rst @@ -329,7 +329,7 @@ And sometimes you even want mutable objects as default values (ever used acciden >>> cp ConnectionPool(db_string='postgres://localhost', pool=deque([Connection(socket=42)]), debug=False) -More information on why class methods for constructing objects are awesome can be found in this insightful `blog post `_. +More information on why class methods for constructing objects are awesome can be found in this insightful `blog post `_. Default factories can also be set using a decorator. The method receives the partially initialized instance which enables you to base a default value on other attributes: diff --git a/docs/why.rst b/docs/why.rst index 4019aaf05..980741642 100644 --- a/docs/why.rst +++ b/docs/why.rst @@ -138,7 +138,7 @@ With ``attrs`` your users won't notice a difference because it creates regular, …Data Classes? -------------- -:pep:`557` added Data Classes to `Python 3.7 `_ that resemble ``attrs`` in many ways. +:pep:`557` added Data Classes to `Python 3.7 `_ that resemble ``attrs`` in many ways. They are the result of the Python community's `wish `_ to have an easier way to write classes in the standard library that doesn't carry the problems of ``namedtuple``\ s. To that end, ``attrs`` and its developers were involved in the PEP process and while we may disagree with some minor decisions that have been made, it's a fine library and if it stops you from abusing ``namedtuple``\ s, they are a huge win.