Message260526
| Author |
fdrake |
| Recipients |
Tony R., berker.peksag, docs@python, ezio.melotti, fdrake, georg.brandl, martin.panter |
| Date |
2016年02月19日.17:37:14 |
| SpamBayes Score |
-1.0 |
| Marked as misclassified |
Yes |
| Message-id |
<1455903434.77.0.47072571677.issue26366@psf.upfronthosting.co.za> |
| In-reply-to |
| Content |
Another reason to value the status-quo in this case is that this isn't just
a matter for the Python documentation; it's about the recommended usage for
the markup, which is used by many other packages.
Questions that should be discussed include:
1. Should we clarify the documentation for the current annotations to
the intended use is more consistently understood, or should we leave
it as-is?
2. Are other distinct kinds of annotations (such as per-parameter notes)
needed?
If so, we'll need to consider specific reader / information-content
needs and determine how they should be marked using new constructs.
This is independent of implementation, which is likely straightforward. |
|