This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.
As a resolution of bug 29602 a new section was added (22.2 Options) that mimics section 1.5 Options from the F&O 3.1 specification. I find it oddly placed, in between extra XSLT functions on handling JSON. While it is true that currently only one function requires "option parameter conventions", its intended meaning is wider, and could be adopted in extension functions (i.e., think EXPath or vendor extensions). I'd like to do the same as in F&O (where it is placed near the top) and place it somewhere near the introduction material, for instance as a subsection under "2 Concepts", which has more such information that applies generally to the whole specification. Marked editorial, as I don't think there's anything wrong per se.
In addition, both for F&O and XSLT, I find the section title "Options" rather generic and its intent is not clear from the title. I.e., calling it "Option parameters" or "Option parameter conventions" seems more substantive and to the point.
I have changed the title of the section to "Option Parameter Conventions". I'm going to leave it where it is in the document; if the option parameter conventions are ever used for more than one XSLT-defined function, I think it is almost certain that we will be able to drop this section and refer to the F+O 3.1 version. So long as it's only used for one function, I think it makes sense to put it near that function.