Re: GitHub ·qtspecs· Repository • Labels

> Scope
>   • Editorial: Minor typos, wording clarification, example fixes, etc.
>   • Bug: Something that does not work with the current specification that
needs updating, but which is more than just fixing a typo.
>   • Enhancement: Something that is not a new feature, but that modifies
or improves on an existing feature (either existing in a published spec, or
in a draft spec).
>   • Feature: Something that introduces new functionality to the
language(s) or function library


Can we add to this list: "Document hidden features", or maybe "Unveil
hidden features"?

One example is that since XPath 2.0 a new powerful feature was introduced
that an axis step can be a function call, but even today very few people
are aware of this. That this feature exists can only be proven traversing a
chain of grammar rules, which most people will never do. More about this
can be found here and in the subsequent thread:
https://www.biglist.com/lists/lists.mulberrytech.com/xsl-list/archives/202208/msg00074.html

There may be other such hidden gems, which by definition are difficult to
find ...

Thanks,
Dimitre

On Wed, Sep 7, 2022 at 12:34 AM Christian Grün <cg@basex.org> wrote:

> Dear all,
>
> As proposed by Reece, we’ve assembled sets of labels that we believe
> should be added to the qtspecs repository in order to better organize the
> variety of existing and new issues:
>
> Language
> • XPath: XML Path Language
> • XQuery: XML Query Language
> • XSLT: XSL Transformations
> • XQFO: XPath and XQuery Functions and Operators
>
> Priority
> • P1: high priority
> • P2: medium priority
> • P3: low priority
>
> Scope
> • Editorial: Minor typos, wording clarification, example fixes, etc.
> • Bug: Something that does not work with the current specification that
> needs updating, but which is more than just fixing a typo.
> • Enhancement: Something that is not a new feature, but that modifies or
> improves on an existing feature (either existing in a published spec, or in
> a draft spec).
> • Feature: Something that introduces new functionality to the language(s)
> or function library
>
> Status
> • Accepted: Will be adopted and added to the specifications.
> • Rejected: As decided in a weekly meeting. A short justification should
> be added in a final comment.
>
> Trivia: The labels of a label set should be uniformly colored. The
> existing standard GitHub labels can be dropped.
>
> Suggestions are welcome.
>
> Best,
> Christian
>
>
>
>

-- 
Cheers,
Dimitre Novatchev
---------------------------------------
Truly great madness cannot be achieved without significant intelligence.
---------------------------------------
To invent, you need a good imagination and a pile of junk
-------------------------------------
Never fight an inanimate object
-------------------------------------
To avoid situations in which you might make mistakes may be the
biggest mistake of all
------------------------------------
Quality means doing it right when no one is looking.
-------------------------------------
You've achieved success in your field when you don't know whether what
you're doing is work or play
-------------------------------------
To achieve the impossible dream, try going to sleep.
-------------------------------------
Facts do not cease to exist because they are ignored.
-------------------------------------
Typing monkeys will write all Shakespeare's works in 200yrs.Will they write
all patents, too? :)
-------------------------------------
Sanity is madness put to good use.
-------------------------------------
I finally figured out the only reason to be alive is to enjoy it.