[Doc-SIG] structured function documentation: preferred markup?

[AC]

> I'm currently using Epytext [...]
> However, that seems excessively verbose

Also, I'm not sure how to indicate optional arguments, as well as valid values
for certain arguments (e.g. action=["GET"|"PUT"|"POST"|"DELETE"]).