Commit Graph

34 Commits

Author SHA1 Message Date
Hynek Schlawack 9f118b7dd5 Tune first steps 2022-07-28 11:00:37 +02:00
Hynek Schlawack 0010bb55fe Make project information easiert to read/scan 2022-07-27 16:11:24 +02:00
Hynek Schlawack 36ed02046e Reorder docs, remove search link
Search link makes no sense with our theme.

Fixes #984
2022-07-16 18:30:12 +01:00
Hynek Schlawack 980c8b04f5
Drop Python 2.7 (#936)
* Drop Python 2.7

The tooling situation around Python 2 has deteriorate to such a degree that
upholding compatibility is not tenable anymore for a volunteer-run project.

Signed-off-by: Hynek Schlawack <hs@ox.cx>

* Add newsfragment

* Run Python 3.5 under coverage to make up for Python 2.7

* Wait for py35 in parallel

* Remove fullmatch kludge

* Remove Python 2-specific code

* Revert empty slot test

Also disable pyupgrade on that file.

Signed-off-by: Hynek Schlawack <hs@ox.cx>

* We DO run under 3.5

* Remove __qualname__ workarounds

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Update changelog.d/936.breaking.rst

Co-authored-by: Tin Tvrtković <tinchester@gmail.com>

* Compare methods using is

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Tin Tvrtković <tinchester@gmail.com>
2022-03-21 08:47:47 +01:00
Hynek Schlawack e8f552c6f0 invert 2021-12-24 12:40:19 +01:00
Hynek Schlawack 0b95a0c76c
Fold backward-compatibility into changelog
Signed-off-by: Hynek Schlawack <hs@ox.cx>
2021-11-25 17:06:12 +01:00
Hynek Schlawack 16cf4c50a0
GitHub really wants us to use Markdown
Signed-off-by: Hynek Schlawack <hs@ox.cx>
2021-11-25 09:31:17 +01:00
Hynek Schlawack 29447f81af
Document the various core names and why they exist (#871)
* Document the various core names and why they exist

Signed-off-by: Hynek Schlawack <hs@ox.cx>

* Remove stray backtick

* Add example of new API

* Link PEP 526

* future is now

* phrase and typos

* typo/grammar

* typo

* Better phrasing

* Add missing and

* less words = better

* polish

* phrasing

* looks weird but is correct

* comma spliiiiceeeee

* example

* make it sound less dry

* fix

* phrasing
2021-11-24 09:39:41 +01:00
Hynek Schlawack 8592ea6aa5 Stack Overflow is two words 2021-10-28 07:11:16 +02:00
Kyle Altendorf 2eb5d97ef3
create a :mod:`attr` and :mod:`attrs` for intersphinx links to the package itself (#850)
* Try to create a :mod:`attr` and :mod:`attrs`

https://github.com/python-attrs/attrs/issues/849

* Update index.rst

* Update index.rst

* Update index.rst
2021-10-12 14:55:26 +02:00
Hynek Schlawack 58d2adce57
Document comparison (#768)
* Document comparison

* Grammar

* Stress independence of eq/order

* Add example for eq

* Be consistent with fields

* Update docs/comparison.rst

Co-authored-by: Julian Berman <Julian@GrayVines.com>

* Update docs/comparison.rst

Co-authored-by: Julian Berman <Julian@GrayVines.com>

* Update docs/comparison.rst

Co-authored-by: Julian Berman <Julian@GrayVines.com>

* Clarify

Co-authored-by: Julian Berman <Julian@GrayVines.com>
2021-02-26 07:53:57 +01:00
Hynek Schlawack 609b10e84f Refactor docs and switch to RTD theme
Our API docs are much more readable on it.

Remove testimonials, they don't serve that much and take up space.

Slightly refactor main docs page.
2020-03-08 07:46:56 +01:00
Julian Berman 8824dc26c2 Add default_role for Sphinx. (#571)
* Add default_role for Sphinx.

Fix a bunch of broken refs along the way, which become
errors now via -W if you have default_role set.

In theory you can catch those via sphinx-build -n (i.e.
nitpick mode), which IMHO is a decent idea anyhow, but it's
a longer diff to enable that because it'd involve fixing a
bunch of the places that try to reference types that don't
exist (e.g. :type foo: Any value). But obviously can be done.

Also didn't actually use this anywhere yet (the any role),
but will do so in a follow-up if this is acceptable.

* Remove the roles from builtin objects to demo any.

* Style.

* Add z.i to intersphinx.

Enables the link to z.i.Interface.

* Enable nitpick mode.

Fix the remaining broken links or whitelist them via nitpick_ignore.

* Kill all :func:s.

* Kill all :class:es.

* Kill all :doc:s.

* Kill all :ref:s.

Except one, that probably meant :func:, and which
is a duplicate ref.

* Kill :exc: and :data:.

* Kill :mod:s.

* Kill new explicit refs from the merge.
2019-09-09 15:02:16 +02:00
Hynek Schlawack 7b37354aa4
Add Python 2 statement (#498) 2019-02-10 07:32:19 +01:00
Hynek Schlawack a6955bff7d
Add narrative docs for type annotations (#406)
* Add narrative docs for type annotations

* Better wording

* Use better code-block types

* Add newsfragment for #238 that refers to these docs
2018-07-28 12:05:12 +01:00
Hynek Schlawack db7c37eda8
Add glossary & make slotted classes official (#371)
* Add glossary & make slotted classes official

* Add missing import
2018-05-02 07:24:04 +02:00
Hynek Schlawack 879f43d355 Add narrative chapter about initialization (#370)
* Add narrative chapter on initialization

* Be more explicit about defining validators both ways

* Stress that the name of default/validator != attr name

* Mention nested schemas

* Explain handling of private attributes

* Add another consequence of _ stripping

* Stress that nothing should overwrite attributes on class body

* Better wording

* typo

* Dedup examples

* Address review feedback

* Add newsfragments
2018-04-25 00:07:03 +02:00
Hynek Schlawack 57817b2c0e
Add a narrative chapter on object hashing (#369)
* Add a narrative chapter on object hashing

* Simplify

* Add a "what to do" to the tl;dr warning

* Shuffle around

* Fix typos
2018-04-16 07:49:34 +02:00
Hynek Schlawack 7501cecf0f m(
fixes #283
2017-11-08 19:21:26 +01:00
Hynek Schlawack 3d3d49b4dd Prepare for narrative docs (#275) 2017-10-26 17:55:45 +02:00
Hynek Schlawack 5e594ca580 We want to simplify writing classes; not attributes 2017-02-20 16:22:29 +01:00
Hynek Schlawack 8ad7602992 More copyediting
The correct parts being based on feedback from @econchick
2016-08-17 13:28:00 +02:00
Hynek Schlawack 563b09f19a Pull license up 2016-08-15 21:51:20 +02:00
Hynek Schlawack 5dd257f878 Treat main title as a title 2016-08-15 17:35:49 +02:00
Hynek Schlawack b040503663 More documentation polish 2016-08-15 17:26:49 +02:00
Hynek Schlawack 395aa07820 Documentation overhaul 2016-08-15 13:59:04 +02:00
Hynek Schlawack 27e2f4e5c0 Document how to extend attrs 2015-03-23 10:32:13 +01:00
Hynek Schlawack 1f5513e098 Shorten creed 2015-02-21 11:36:08 +01:00
Hynek Schlawack f7597c795f Clarify backward compatibility + polish API docs 2015-02-01 19:27:36 +01:00
Hynek Schlawack 2040ed5e48 Replace motto 2015-01-29 17:33:58 +01:00
Hynek Schlawack 8bfa3a3c6f Don't strip teaser 2015-01-29 09:13:16 +01:00
Hynek Schlawack 3f2fd8317d More doc polishing 2015-01-28 16:55:45 +01:00
Hynek Schlawack c7381fd0e2 Gut docs for now 2015-01-27 23:03:04 +01:00
Hynek Schlawack 9560908555 Initial commit
Docs aren't there yet
2015-01-27 17:53:17 +01:00