Add more details on how operations between values of different types work

Open
#374 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
58/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Active
Domain
documentation

Research direction

Start by reading the specification sections that describe operations between values and identify how they handle types. Add details covering comparisons between a date and a string date, and subtracting a time from a date; done when the specification explains these examples. The issue does not name specific files or tests.

Written by the indexing model from the issue text.

Description

For example, comparing a date to a string date, subtracting a time from a date, etc.

XPath 1.0 only defines 4 types: node-set, boolean, number, string.
XPath 1.0 has explicit rules for each operator and how implicit type coercion takes place on its operands (ref).

W3C XForms adds to that type list and ODK XForms has made its own extensions. Clients have diverged in how they interpret certain expressions.

Dominant language
CSS
Stars
34
Forks
29
PR merge metrics
No merged PRs in 30d

Getting set up

  • Ships a Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from getodk/xforms-spec

All issues in getodk/xforms-spec

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.