Re: [Docutils-develop] Removing to-do list entries

[David G. <go...@py...>]

Below, read "DND" as "don't delete; add your comments instead".  One
important use of a to-do list is for posterity: to remember ideas that
may not be so good, and/or perhaps should not be implemented.
Marginal ideas often recur; it's useful to be able to point this out,
and the to-do list is useful as community memory.

[r3714] DND

[r3716]
> There is not much point in supporting grid tables inside XML
> comments.  List tables should suffice for the few cases where it is
> needed.

DND
("not *much* point", "should suffice" are telling)

[r3719]
> Removed entry about header/footer and pages.
> There are no pages in a generic document format.

DND

Documents with pages are generic enough -- it's only in the last few
decades that documents *without* pages have come to be.

[r3720]
> There is probably no need for including a range of lines. Too
> complicated.

DND
IIRC, this originated with a user request.

[r3721] DND

[r3722] DND

[r3723]
> Do not add imagemap directive.
> No requests, and after all it is HTML-specific.

DND
So what if it's HTML-specific?  That's a major Docutils use case.
Some ideas don't originate with user requests, but come from my own
imagination.  See my home page for an imagemap example, and my
workaround.

[r3724 & r3725] Add to docs/dev/rst/alternatives.txt.

[r3726] Add to docs/dev/rst/alternatives.txt.

[r3728]
> Removed entry about "settings" directive.
> Much thought and discussion is required to make this work.

Deleting the entry will not foster thought or discussion.

[r3730]
> Do not add "faq" directive. It is a too specific use-case to
> justify a directive on it's own, and using section titles for FAQ
> entries works fine.

DND
FAQs (or Q&As) are a common use of reST, and some native support would
be nice.  Using sections as a workaround still has a bit of a bad
smell.

[r3732]
> Do not add acronym role. ...

DND or add to docs/dev/rst/alternatives.txt.  Acronym & abbreviation
elements are already part of the Docutils document model; adding
support to reST is only logical.

[r3733] DND or add to docs/dev/rst/alternatives.txt.

[r3734] Add to docs/dev/rst/alternatives.txt.

[r3737] DND, or combine with r3721.

[r3743] may need modification, since the deletions it refers to may
not be happening after all.

... that's all, folks!

--
David Goodger <http://python.net/~goodger>