getodk / getodk/docs

Re-org (re-think) form building section

Open
#457 1 comment 0 reactions 0 assignees View on GitHub
Form design ODK
Dominant language
Python
Stars
58
Forks
160
Avg merge
5d 11h
Merged PRs (30d)
12

Description

This is the most disjointed and disorganized section of the docs.
The Intro to Forms page helped a lot, but it's still kind of a mess.

It would probably help to divide it into sections.

Possibly:

- XForm
- XLSForms
- Forms in Collect <--- Not sure what to call this

I have to think about this some more. Opinions welcome.

Contributor guide

Open the contributing guide

Research direction

Start by reviewing the existing Intro to Forms page and the surrounding form-building documentation. Compare the proposed XForm, XLSForms, and Forms in Collect groupings, then define a settled section structure and update the documentation so users can find each topic consistently.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.