[issue34015] doc Add link to Descriptor HowTo Guide in Data Model

2018-07-03 Thread Raymond Hettinger
Raymond Hettinger added the comment: 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. -- nosy: +rhettinger resolution: -> rejected stage: patch review -> resolved

[issue34015] doc Add link to Descriptor HowTo Guide in Data Model

2018-07-01 Thread Andrés Delfino
Andrés Delfino added the comment: ok :) I have just updated the PR following your comment. -- ___ Python tracker ___ ___

[issue34015] doc Add link to Descriptor HowTo Guide in Data Model

2018-07-01 Thread INADA Naoki
INADA Naoki added the comment: I think "See also" is better than sidebar. Many other sections in data-model chapter have it. -- nosy: +inada.naoki ___ Python tracker ___

[issue34015] doc Add link to Descriptor HowTo Guide in Data Model

2018-06-30 Thread Andrés Delfino
Change by Andrés Delfino : -- keywords: +patch pull_requests: +7647 stage: -> patch review ___ Python tracker ___ ___

[issue34015] doc Add link to Descriptor HowTo Guide in Data Model

2018-06-30 Thread Andrés Delfino
New submission from Andrés Delfino : 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