sphinx-contrib / datatemplates

Sphinx plugin for generating RST on the fly from data files and templates.
http://sphinxcontribdatatemplates.readthedocs.io/
Other
44 stars 19 forks source link

Settle the directive syntax #52

Open janbrohl opened 4 years ago

janbrohl commented 4 years ago

by @dhellmann

dhellmann commented 4 years ago

I think I like the approach of using different directives based on the format of the input best. That allows us to have format-specific options, which we know we need in a few cases. It also makes it easy to document the directives and their options cleanly.

If you agree, we can close this question and open a ticket to remove the old legacy format before we release 1.0.

janbrohl commented 4 years ago

Actually, we could use tha plain directive for autodetection like #40