search

expath / xpath-ng

Wishlist for XPath Syntax Extensions
Creative Commons Attribution 4.0 International
12 stars 4 forks source link
xforms xpath xproc xquery xslt

readme

Creative Commons Licence - BY 4.0 Code of Conduct

XPath Syntax Extensions Wishlist 🧚

The purpose of this repository is to collaborate on and collate syntax extensions that XPath users would like to see in a future version of XPath.

This repository is not for proposing extension modules or functions for XPath (or XPath derived languages), such efforts belong elsewhere. The focus here is extending the core grammar of the XPath language.

Sometimes it is not immediately obvious whether a language extension is applicable to the whole XPath sphere or just to XQuery. We are also happy to accept proposals which may only be destined for XQuery. When a proposal is only relevant for XQuery, we will mark it as such.

Proposal Process

  1. Fork the GitHub repository.
  2. Make a copy of the proposal-template.md file to your-short-proposal-name.md.
  3. Write up your proposal in your your-short-proposal-name.md file using Markdown syntax.
  4. Git commit the your-short-proposal-name.md file.
  5. Modify this README.md file to add your proposal to the Proposed Syntax Extensions list, and commit it.
  6. Send a Pull Request just for your-short-proposal.md file.
  7. Await comments and feedback in the Pull Request.

Pull requests comments will be used to discuss a proposal. Commits can be further added by the author to a Pull Request to incorporate feedback etc.

TODO - we need some sort of disagreement resolution policy / vote procedure.

Code of Conduct

Yes we all have different ideas about what we consider to be beautiful syntax. Please consider the underlying ideas of a proposal when commenting and not just whether you like the syntax or not. Once the idea being proposed is concrete enough, we can at the end discuss exact syntax etc.

Please treat others better than you would like to be treated yourself and avoid comments which might be interpreted as personally inappropriate. We have adopted the Contributor Covenant, so if in doubt please see the Code of Conduct.

Proposed Syntax Extensions

Here we categorise, list and link to each syntax extension that has been proposed so far.

Any proposals are XQuery specific, should be clearly marked as such with: "(XQuery only)"

  1. TODO link proposals here.