Document PEP 3134 in tutorials/errors.rst

[maxking]

BPO	37826
Nosy	@rhettinger, @methane, @maxking, @miss-islington
PRs	bpo-37826: Document exception chaining in Python tutorial for errors. #15243 bpo-42179: Doc/tutorial: Remove mention of __cause__ #23162

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2019-08-16.21:58:04.426>
created_at = <Date 2019-08-11.18:36:06.429>
labels = ['docs']
title = 'Document PEP 3134 in tutorials/errors.rst'
updated_at = <Date 2020-11-05.09:05:04.157>
user = 'https://github.com/maxking'

bugs.python.org fields:

activity = <Date 2020-11-05.09:05:04.157>
actor = 'methane'
assignee = 'docs@python'
closed = True
closed_date = <Date 2019-08-16.21:58:04.426>
closer = 'maxking'
components = ['Documentation']
creation = <Date 2019-08-11.18:36:06.429>
creator = 'maxking'
dependencies = []
files = []
hgrepos = []
issue_num = 37826
keywords = ['patch']
message_count = 4.0
messages = ['349406', '349426', '349510', '349751']
nosy_count = 5.0
nosy_names = ['rhettinger', 'methane', 'docs@python', 'maxking', 'miss-islington']
pr_nums = ['15243', '23162']
priority = 'normal'
resolution = None
stage = 'resolved'
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue37826'
versions = []

[maxking]

Looking at the docs, I couldn't find the raise from documentation anywhere in the Errors and Exceptions page (https://docs.python.org/3/tutorial/errors.html) page, which seems to be the landing page for Python Exceptions.

I do see however that it is documented on the top page of https://docs.python.org/3/library/exceptions.html and raise statement's docs (https://docs.python.org/3/reference/simple_stmts.html#raise), both of which are pretty hard to discover.

It would be nice to add the docs for raise from in the Errors and Exception page too.

[rhettinger]

This is a reasonable suggestion.

Would you like to submit a pull request?

[maxking]

Yes, I am gonna work on a PR.

[miss-islington]

New changeset dcfe111 by Miss Islington (bot) (Abhilash Raj) in branch 'master':
bpo-37826: Document exception chaining in Python tutorial for errors. (GH-15243)
dcfe111