doc Add link to Descriptor HowTo Guide in Data Model

[andresdelfino]

BPO	34015
Nosy	@rhettinger, @methane, @andresdelfino
PRs	bpo-34015: Add link to Descriptor HowTo Guide #8037

^{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 2018-07-03.15:15:22.814>
created_at = <Date 2018-07-01.01:34:21.831>
labels = ['3.8', 'type-feature', '3.7', 'docs']
title = 'doc Add link to Descriptor HowTo Guide in Data Model'
updated_at = <Date 2018-07-03.15:15:22.799>
user = 'https://github.com/andresdelfino'

bugs.python.org fields:

activity = <Date 2018-07-03.15:15:22.799>
actor = 'rhettinger'
assignee = 'docs@python'
closed = True
closed_date = <Date 2018-07-03.15:15:22.814>
closer = 'rhettinger'
components = ['Documentation']
creation = <Date 2018-07-01.01:34:21.831>
creator = 'adelfino'
dependencies = []
files = []
hgrepos = []
issue_num = 34015
keywords = ['patch']
message_count = 4.0
messages = ['320821', '320829', '320835', '320986']
nosy_count = 4.0
nosy_names = ['rhettinger', 'methane', 'docs@python', 'adelfino']
pr_nums = ['8037']
priority = 'normal'
resolution = 'rejected'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue34015'
versions = ['Python 2.7', 'Python 3.6', 'Python 3.7', 'Python 3.8']

[andresdelfino]

IMHO, it would be useful to make the Descriptor HowTo Guide more discoverable. As far as I can see, we are not linking to it from anywhere except the HOWTO index. Section 3.3.2.2., "Implementing Descriptors", in "Data Model" seems to be the most appropriate place.

[methane]

I think "See also" is better than sidebar.
Many other sections in data-model chapter have it.

[andresdelfino]

ok :) I have just updated the PR following your comment.

[rhettinger]

I don't want to do this. The docs are the authoritative source and the how-to is a secondary source that is primarily about how particular descriptors are implemented.