Issue 34015: doc Add link to Descriptor HowTo Guide in Data Model
Created on 2018-07-01 01:34 by adelfino, last changed 2022-04-11 14:59 by admin. This issue is now closed.
| Pull Requests | |||
|---|---|---|---|
| URL | Status | Linked | Edit |
| PR 8037 | closed | adelfino, 2018-07-01 01:35 | |
| Messages (4) | |||
|---|---|---|---|
| msg320821 - (view) | Author: Andrés Delfino (adelfino) *  |
Date: 2018-07-01 01:34 | |
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. |
|||
| msg320829 - (view) | Author: Inada Naoki (methane) *  |
Date: 2018-07-01 08:03 | |
I think "See also" is better than sidebar. Many other sections in data-model chapter have it. |
|||
| msg320835 - (view) | Author: Andrés Delfino (adelfino) * |
Date: 2018-07-01 11:53 | |
ok :) I have just updated the PR following your comment. |
|||
| msg320986 - (view) | Author: Raymond Hettinger (rhettinger) * |
Date: 2018-07-03 15:15 | |
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. |
|||
| History | |||
|---|---|---|---|
| Date | User | Action | Args |
| 2022-04-11 14:59:02 | admin | set | github: 78196 |
| 2018-07-03 15:15:22 | rhettinger | set | status: open -> closed nosy:
+ rhettinger resolution: rejected |
| 2018-07-01 11:53:34 | adelfino | set | messages: + msg320835 |
| 2018-07-01 08:03:12 | methane | set | nosy:
+ methane messages: + msg320829 |
| 2018-07-01 01:35:37 | adelfino | set | keywords:
+ patch stage: patch review pull_requests: + pull_request7647 |
| 2018-07-01 01:34:21 | adelfino | create | |