This issue tracker has been migrated to GitHub ,
and is currently read-only.
For more information,
see the GitHub FAQs in the Python's Developer Guide.
Created on 2015年03月25日 15:22 by demian.brecht, last changed 2022年04月11日 14:58 by admin. This issue is now closed.
| Files | ||||
|---|---|---|---|---|
| File name | Uploaded | Description | Edit | |
| versionchanged_indent.patch | demian.brecht, 2015年03月25日 15:22 | |||
| Messages (5) | |||
|---|---|---|---|
| msg239261 - (view) | Author: Demian Brecht (demian.brecht) * (Python triager) | Date: 2015年03月25日 15:22 | |
This came up during #2211, where a multiline versionchanged entry was suggested. Currently, there is no visual distinction between any but the first line of the description and the rest of the body of the docs. The attached patch adds a consistent level of indentation (30px) to all but the first child. This change makes it much more obvious where the versionchanged block ends and the rest of the docs continue. |
|||
| msg239263 - (view) | Author: R. David Murray (r.david.murray) * (Python committer) | Date: 2015年03月25日 15:34 | |
Heh, you clearly know more about docutils/css than I do. I don't think we want multiple blank delimited paragraphs under a versionchanged directive, though, from a style point of view. A compact unordered list would be best. |
|||
| msg239270 - (view) | Author: Demian Brecht (demian.brecht) * (Python triager) | Date: 2015年03月25日 16:27 | |
I noted in #2211 that nested lists are supported by Sphinx, so that solves that specific issue. Perhaps it /may/ still be useful to have this though in order to support multiple paragraphs for more detailed change descriptions when needed? That said, I'm not sure that's something that's necessarily even wanted as such messages are intended to be terse. |
|||
| msg239273 - (view) | Author: R. David Murray (r.david.murray) * (Python committer) | Date: 2015年03月25日 16:42 | |
Yes, exactly, they are supposed to be terse. So I think we should reject this. |
|||
| msg239274 - (view) | Author: Demian Brecht (demian.brecht) * (Python triager) | Date: 2015年03月25日 16:48 | |
Sounds good to me. |
|||
| History | |||
|---|---|---|---|
| Date | User | Action | Args |
| 2022年04月11日 14:58:14 | admin | set | github: 67966 |
| 2015年03月25日 16:48:06 | demian.brecht | set | messages: + msg239274 |
| 2015年03月25日 16:42:01 | r.david.murray | set | status: open -> closed resolution: rejected messages: + msg239273 stage: patch review -> resolved |
| 2015年03月25日 16:27:33 | demian.brecht | set | messages: + msg239270 |
| 2015年03月25日 15:34:27 | r.david.murray | set | nosy:
+ georg.brandl, r.david.murray messages: + msg239263 |
| 2015年03月25日 15:22:15 | demian.brecht | create | |