getodk / getodk/docs

How to use logic (relevants, constraints, calculates) in Build

Open
#752 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
58
Forks
160
Avg merge
5d 11h
Merged PRs (30d)
12

Description

The XLSForm syntax is not supported by Build. For example, to refer to another field, we must use XPath syntax -- `/data/first_name`. This is not immediately obvious and causes confusion for users (e.g. https://forum.opendatakit.org/t/guide-me-on-setting-up-skips-on-build/13739/5)

Contributor guide

Open the contributing guide

Research direction

No documentation file or test is named in the issue. Start by locating the Build documentation for relevant, constraint, and calculate expressions; document that field references use XPath rather than XLSForm syntax, with an example, so users can configure these expressions without confusion.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.