From e625a28e60ed0c5f7e57e4065e9aa01e4b89a5bf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?H=C3=A9l=C3=A8ne=20Martin?= Date: Wed, 30 Apr 2025 11:09:28 -0700 Subject: [PATCH 1/5] Add section on offline Enketo links --- docs/_static/css/custom.css | 4 ++ docs/central-submissions.rst | 111 ++++++++++++++++++++++++++++------- 2 files changed, 94 insertions(+), 21 deletions(-) diff --git a/docs/_static/css/custom.css b/docs/_static/css/custom.css index fa667f22f..37ce8344d 100644 --- a/docs/_static/css/custom.css +++ b/docs/_static/css/custom.css @@ -31,6 +31,10 @@ width: 365px; } +.central-partial-screen { + width: 400px; +} + table.schema-table-wrap { width: 100%; } diff --git a/docs/central-submissions.rst b/docs/central-submissions.rst index df51a6bb1..fe700d554 100644 --- a/docs/central-submissions.rst +++ b/docs/central-submissions.rst @@ -3,39 +3,54 @@ Managing Submissions in Central =============================== -The most common way to use ODK Central is in conjunction with a data collection client, typically on a mobile device, such as ODK Collect. To do this, you will need to :ref:`connect to it from your mobile device `, after which you will be able to :ref:`upload submissions ` back to Central. +When users fill out forms and submit them, Central receives Submissions. Central users with the right roles can then :ref:`manage those Submissions ` directly in Central, :ref:`download them `, or :ref:`connect to them ` from an external tool like Excel. -ODK Central also bundles `Enketo `_, which enables preview and submission of forms directly from a web browser. Please note that as with all ODK clients, Enketo does not always behave quite the same as Collect, or support the same features. Any authorized Web User may fill out a Form directly from the browser, as will be described in more detail below. +.. _central-web-submissions: -Finally, ODK Central offers Public Access Links. A Public Access Link grants anybody in possession of the link the ability to submit to a Form on your server. You can control whether each respondent can submit more than once, and revoke access from any Link at any time. +Making Submissions from the web +--------------------------------- -Submissions sent to Central are available to browse in a preview table, to connect directly to data analysis tools, and for download. +In general, we recommend using the :doc:`ODK Collect Android application ` when doing enumerator-mediated data collection, especially in offline conditions or when using multiple forms for a single project. To do this, you will need to :ref:`connect to Central from your mobile device `, and then you will be able to :ref:`send submissions ` back to Central. However, there are many scenarios in which web forms may be more appropriate: + +* Self-report. Use single-submission :ref:`Public Access Links ` that participants can fill out from any device. +* Public surveys. Use :ref:`Public Access Links ` and share them on a poster as a QR code, by email, etc. +* Non-Android mobile devices. You can give enumerators :ref:`Data Collector roles ` in your project or send :ref:`Public Access Links ` for them to bookmark. +* Data entry from paper forms. Web forms can be used at a computer with a keyboard to quickly transcribe data collected on paper. + +ODK Central bundles `Enketo `_ to enable editing, previewing and submitting forms directly from a web browser. + +.. note:: + + Enketo does not always behave exactly like Collect, or support all the same features. The :doc:`XLSForm template ` provides compatibility information and we recommend testing your form as you expect users to interact with it. + +Any authorized Web User may fill out a Form directly from the browser, as will be described in more detail below. Additionally, ODK Central offers Public Access Links which grant anybody in possession of the link the ability to submit to a Form on your server. You can control whether each respondent can submit more than once, and revoke access from any Link at any time. It is also possible to make Enketo web forms :ref:`usable while offline `. .. _central-submissions-direct: Direct Web Browser Submissions ------------------------------- +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Web Users who are Administrators, Project Managers, or Data Collectors can directly fill Forms in the web browser from the Central administration website. This functionality is provided by Enketo, which does not always behave quite the same as Collect, or support the same features. - .. image:: /img/central-submissions/new.png +.. image:: /img/central-submissions/new.png Administrators and Project Managers can begin a survey by going to the :guilabel:`Submissions` tab of the Form, and clicking on the :guilabel:`New` button next to the Submissions header. This will open a new tab which will load the Form in Enketo. - .. image:: /img/central-submissions/data-collector-form-listing.png +.. image:: /img/central-submissions/data-collector-form-listing.png Data Collectors do not have access to the detailed Form management pages. Instead, they will find a :guilabel:`Fill Form` button next to the Form name in the list of Forms on the Project Overview page. .. _central-submissions-public-link: Public Access Links -------------------- +~~~~~~~~~~~~~~~~~~~ ODK Central allows the distribution of surveys to a broad or open respondent group using Public Access Links. These Links take recipients directly to the Form in their web browser, administered by Enketo. To create a Public Access Link, go to the Form's :guilabel:`Public Access` tab. Click on :guilabel:`Create Public Access Link…` to begin. - .. image:: /img/central-submissions/public-link-new.png +.. image:: /img/central-submissions/public-link-new.png + :class: central-partial-screen In the window that appears, you'll need to name the Link. This name is for your own identification purposes in the administration website, and is not displayed to respondents. @@ -49,14 +64,14 @@ You'll also need to decide whether to allow multiple submissions per respondent. Once a Link is created, it will appear in the table, along with a web address you can copy and paste to distribute the Link to respondents. - .. image:: /img/central-submissions/public-link-listing.png +.. image:: /img/central-submissions/public-link-listing.png -You cannot yet edit any of the details of a Public Link. This will come in a future version of Central. +You cannot yet edit any of the details of a Public Link. .. _central-submissions-link-revoke: Revoking a Link -~~~~~~~~~~~~~~~ +^^^^^^^^^^^^^^^ You can revoke a Link at any time to prevent any further Submissions through it. Once a Link is revoked, all Submissions will be immediately denied, and new attempts to load the Form using the Link will result in an error instead. @@ -69,7 +84,7 @@ Accessing Submissions To find the Form submissions page, first find the form in the Form listings page (:menuselection:`--> Forms`) and click on it. You will be taken to the :ref:`Form Overview ` page for that form. Click on the :menuselection:`--> Submissions` tab below the form name to find the submissions. - .. image:: /img/central-submissions/listing.png +.. image:: /img/central-submissions/listing.png The table preview you see here will at first show you the first ten fields of your survey and their results, with the latest submissions shown closest to the top. Any downloadable files will appear with a green download link you can use to directly download that media attachment. The submission's instance ID will always be shown at the right side of this preview table. @@ -90,12 +105,12 @@ Learn more about these options below: .. _central-submissions-download: -Downloading submissions as CSVs +Downloading Submissions as CSVs ------------------------------- To download all submission data as :file:`.csv` tables, click on the :guilabel:`Download all # records` button on the right side of the listing page: - .. image:: /img/central-submissions/download-button.png +.. image:: /img/central-submissions/download-button.png If you have any row filters applied to the submission table, those filters will be applied to your download as well. You can use this to, for example, download only submissions from a particular month, or only approved submissions. @@ -106,7 +121,8 @@ Export options Once the download dialog opens, you'll be given some additional export options. - .. image:: /img/central-submissions/download-modal.png +.. image:: /img/central-submissions/download-modal.png + :class: central-partial-screen Some of the options may be disabled if they do not apply to your data, or if they are not available due to features that you have enabled (such as managed encryption). @@ -228,10 +244,10 @@ Once submissions have been reviewed, the submission table download and the OData .. _central-submissions-details: -Submission Details ------------------- +Viewing Submission Details +-------------------------- -As of version 1.2, each submission has its own detail page which provides basic information about the submission, an activity history of action and discussion on that submission, and tools for updating the submission review state and data itself. +Each submission has its own detail page which provides basic information about the submission, an activity history of action and discussion on that submission, and tools for updating the submission review state and data itself. .. image:: /img/central-submissions/details.png @@ -246,8 +262,8 @@ You can leave a note when you update the review state, to indicate why the decis .. _central-submissions-editing: -Submission Editing ------------------- +Editing Submissions +-------------------- From the :ref:`submission detail page ` you can press the :guilabel:`Edit` button to edit the submission in your web browser. When an edited submission is resubmitted, a new version of it is created, just like a form version. You will be able to see previous submission versions in a future version of Central. @@ -257,3 +273,56 @@ Finally, when edits are submitted, the submission :ref:`review state `. + + #. Add ``x/`` after ``/-/`` in the address. For :ref:`Public Access Links `, replace ``single/`` with ``x/``. + + #. Press ``Enter`` on your keyboard, and make sure that you see an orange connectivity icon in the upper left of the form. + + #. Copy the link and share it with your data collector(s) From 2f0793aa51af82d99399ed4639aab620b6af9f03 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?H=C3=A9l=C3=A8ne=20Martin?= Date: Wed, 30 Apr 2025 21:23:30 -0700 Subject: [PATCH 2/5] Add ODK Web Forms page --- docs/central-submissions.rst | 12 ++-- docs/img/web-forms/geopoint-permission.png | 3 + .../web-forms/geopoint-refining-accuracy.png | 3 + docs/index.rst | 1 + docs/web-forms-intro.rst | 70 +++++++++++++++++++ 5 files changed, 85 insertions(+), 4 deletions(-) create mode 100644 docs/img/web-forms/geopoint-permission.png create mode 100644 docs/img/web-forms/geopoint-refining-accuracy.png create mode 100644 docs/web-forms-intro.rst diff --git a/docs/central-submissions.rst b/docs/central-submissions.rst index fe700d554..9ff123a73 100644 --- a/docs/central-submissions.rst +++ b/docs/central-submissions.rst @@ -23,6 +23,10 @@ ODK Central bundles `Enketo `_ to enable editing, previewing Enketo does not always behave exactly like Collect, or support all the same features. The :doc:`XLSForm template ` provides compatibility information and we recommend testing your form as you expect users to interact with it. +.. tip:: + + The ODK team is working on ODK Web Forms which will eventually replace Enketo in Central. Starting in Central v2025.1.0, you can :doc:`try it out `! + Any authorized Web User may fill out a Form directly from the browser, as will be described in more detail below. Additionally, ODK Central offers Public Access Links which grant anybody in possession of the link the ability to submit to a Form on your server. You can control whether each respondent can submit more than once, and revoke access from any Link at any time. It is also possible to make Enketo web forms :ref:`usable while offline `. .. _central-submissions-direct: @@ -282,18 +286,18 @@ Allowing web form users to work offline ODK Web Forms does not yet support offline use. If someone loses connectivity while filling out an ODK Web Forms form, they will be able to complete filling it out but will need an Internet connection before they can submit. -Enketo's offlineable mode makes it possible to launch a form while offline, save drafts of that form, queue submissions to be sent to a server, and automatically send queued submissions once a connection is available. +Enketo's offline-capable mode makes it possible to launch a form while offline, save drafts of that form, queue submissions to be sent to a server, and automatically send queued submissions once a connection is available. .. note:: Queued submissions are automatically sent **only if the form is open** in a browser when a connection is available. -You can make an Enketo form offlineable by changing the form's web address and sharing that modified address. The way to do this depends on your Central version but links from older versions of Central will continue to work in newer versions. +You can make an Enketo form offline-capable by changing the form's web address and sharing that modified address. The way to do this depends on your Central version but links from older versions of Central will continue to work in newer versions. .. tab-set:: .. tab-item:: Central v2025.1.0+ - **Offlineable link that does not require logging in** + **Offline-capable link that does not require logging in** #. Create a Public Access Link for your form. You can create a single shared link or repeat these instructions for each person filling out data so that you can track who is submitting. @@ -305,7 +309,7 @@ You can make an Enketo form offlineable by changing the form's web address and s #. Copy the link that you were redirected to and share it with your data collector(s). - **Offlineable link that requires logging in to submit** + **Offline-capable link that requires logging in to submit** #. Give the :guilabel:`Data Collector` role to any individual who will need to fill out this form. diff --git a/docs/img/web-forms/geopoint-permission.png b/docs/img/web-forms/geopoint-permission.png new file mode 100644 index 000000000..37b2461eb --- /dev/null +++ b/docs/img/web-forms/geopoint-permission.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:d31473531a1b64efdc7b5a309b7e9a835d05821b49ac952f95166c7f992fae1b +size 263697 diff --git a/docs/img/web-forms/geopoint-refining-accuracy.png b/docs/img/web-forms/geopoint-refining-accuracy.png new file mode 100644 index 000000000..7867c170a --- /dev/null +++ b/docs/img/web-forms/geopoint-refining-accuracy.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:0774e977fc1311e56716fc2ee54ba62c146de92d7cee6e04e6411c8074bcbc7b +size 56237 diff --git a/docs/index.rst b/docs/index.rst index b7842ccff..030377d48 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -47,6 +47,7 @@ ODK is open-source software that's made by a welcoming community of people just central-install central-using central-manage + web-forms-intro central-best-practices .. toctree:: diff --git a/docs/web-forms-intro.rst b/docs/web-forms-intro.rst new file mode 100644 index 000000000..95b636265 --- /dev/null +++ b/docs/web-forms-intro.rst @@ -0,0 +1,70 @@ +Trying ODK Web Forms +==================== + +ODK Central provides a web-based interface to your forms for data edits, to preview form definitions, and to enable data collection from devices other than Android phones. You can learn more about :ref:`how Central uses web-based forms `. + +By default, web forms in Central are powered by `Enketo `_, a powerful library that was initially developed outside the ODK project and that the ODK team has contributed to. + +The ODK team is now developing `ODK Web Forms `_ which will eventually replace Enketo in ODK Central. ODK Web Forms is designed to align with ODK Collect and provide a modern user experience. This page describes how to opt into trying ODK Web Forms and documents its functionality. + +To quickly try your forms in ODK Web Forms, see `the preview website `_. This page describes how to :ref:`opt a Central Form into using ODK Web Forms ` for all web-based functions and documents :ref:`more complex question types `. + +.. _web-forms-opt-in: + +Opting into ODK Web Forms in Central +---------------------------------------- + +.. warning:: + ODK Web Forms is experimental and does not support all form functionality! Please test your form carefully. + +Starting in Central v2025.1.0, you can opt individual forms into using `ODK Web Forms `_, an experimental replacement for Enketo designed from the ground up to align with ODK Collect. ODK Web Forms is still early in its development. We recommend trying ODK Web Forms if: + +* You are curious about how web forms will evolve in Central. +* You want to provide feedback and ideas `on the forum `_. +* You have a form that doesn't work well with Enketo. For example, this could be because of the presentation of certain question types such as ``geopoint``, performance issues, or bugs in repeats. + +To opt into ODK Web Forms, go to the :guilabel:`Settings` tab for a specific form. In the :guilabel:`Web Forms` section, select the :guilabel:`ODK Web Forms` option, read the description, and confirm that you want to opt in. + +You can see what functionality is currently supported `on Github `_. In particular, please note that the following sometimes subtle features are not yet supported: + +* :ref:`Dynamic defaults ` and the XLSForm ``trigger`` column +* :ref:`Metadata questions ` +* Entity creation or update +* References to form fields in translated labels and hints (this works for single-language forms) + +You can change a form's setting between Enketo and Web Forms at any time. Any form links that users already have will continue to work and will reflect the setting on the server at the time that the user loads the form link. + +.. _web-forms-question-types: + +Question types +-------------- + +To know which question types are currently supported in Web Forms, see `the Github feature matrix `_. While most supported functionality is very similar to Collect's, this section describes question types with more complex functionality or that differ from Collect. + +Geopoint +~~~~~~~~ + +The :ref:`geopoint question type ` without appearance captures the current location of the device. Currently, this is the only location experience provided by Web Forms, including for edits. In the future, there will be a map-based interface accessible by setting different ``appearance`` values. Additionally, it will be possible to use a map to view and edit a location captured by the default geopoint question type. + +When a form includes a geopoint question, users of the form will see a :guilabel:`Get location` button. When a user taps that button, a dialog will appear, showing the accuracy of the currently-available location or no value if location permissions are not granted yet. If location permissions are not granted yet, the user will also be asked to grant location permissions by their browser. + +.. image:: /img/web-forms/geopoint-permission.* + :alt: Web Forms location permissions request + +.. warning:: + + Different browsers manage location permissions differently. Some may not prompt for the permission and may require users to go to their settings to grant location access. + + If a user denies location permissions to a form, that permission will apply for all forms on that server and a user may need to go to browser settings to grant the permission. + +Once location permissions are granted to Web Forms, it will start reading location data from available sensors on the device. The current location accuracy will be displayed along with qualitative information about that accuracy to help guide the person filling out the form to get the highest accuracy point possible. Location will continue to update until the user taps the :guilabel:`Save location` button or the accuracy reaches the target accuracy defined by the form, whichever comes first. The target accuracy is the value in the "Location will be saved at N m" message. + +.. image:: /img/web-forms/geopoint-refining-accuracy.* + :alt: Web forms location-finding dialog + :class: central-partial-screen + +Image +~~~~~~~~ + +The :ref:`image question type ` without appearance allows the user to capture an image. In Web Forms, if the user is on a mobile device, they can take a picture with their mobile camera. Devices like laptops that use a desktop browser will not show the capture button, even if they have a built-in camera. From 20387fe04f34a9ad47c66fcbb2b4735834346b99 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?H=C3=A9l=C3=A8ne=20Martin?= Date: Thu, 1 May 2025 21:25:08 -0700 Subject: [PATCH 3/5] Review feedback --- docs/web-forms-intro.rst | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/web-forms-intro.rst b/docs/web-forms-intro.rst index 95b636265..a8bc2b3ae 100644 --- a/docs/web-forms-intro.rst +++ b/docs/web-forms-intro.rst @@ -32,7 +32,7 @@ You can see what functionality is currently supported `on Github ` without appearance allows the user to capture an image. In Web Forms, if the user is on a mobile device, they can take a picture with their mobile camera. Devices like laptops that use a desktop browser will not show the capture button, even if they have a built-in camera. +The :ref:`image question type ` without appearance allows the user to capture an image. In Web Forms, if the user is on a mobile device, they can take a picture with their mobile camera. Devices like laptops that use a desktop browser will not show the capture button, even if they have a built-in camera. + +Date +~~~~~ + +The :ref:`date question type ` without appearance allows the user to enter a date. The user can manually type a date in the text field in the mm/dd/yyyy format or click in the field to select a date from a calendar. To change the year, they can press on the current year at the top of the calendar. To change the month, they can use the navigation arrows or press on the current month at the top of the calendar. There are also buttons to clear the date or jump to today. From 2ac52dae1466afbd3bc7950a6b86145cf194ad4e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?H=C3=A9l=C3=A8ne=20Martin?= Date: Mon, 5 May 2025 13:36:32 -0700 Subject: [PATCH 4/5] Add images --- docs/img/web-forms/calendar-yyyy-mm-dd.png | 3 +++ docs/img/web-forms/geopoint-permission.png | 4 ++-- docs/img/web-forms/geopoint-refining-accuracy.png | 4 ++-- docs/img/web-forms/image-desktop.png | 3 +++ docs/web-forms-intro.rst | 14 +++++++++++--- 5 files changed, 21 insertions(+), 7 deletions(-) create mode 100644 docs/img/web-forms/calendar-yyyy-mm-dd.png create mode 100644 docs/img/web-forms/image-desktop.png diff --git a/docs/img/web-forms/calendar-yyyy-mm-dd.png b/docs/img/web-forms/calendar-yyyy-mm-dd.png new file mode 100644 index 000000000..718f4a03b --- /dev/null +++ b/docs/img/web-forms/calendar-yyyy-mm-dd.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:951efcb5ba4f2bdb0b34cfee89afa686016b5bdfa06446f6c32ded87db2efcdb +size 153138 diff --git a/docs/img/web-forms/geopoint-permission.png b/docs/img/web-forms/geopoint-permission.png index 37b2461eb..850052ae9 100644 --- a/docs/img/web-forms/geopoint-permission.png +++ b/docs/img/web-forms/geopoint-permission.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:d31473531a1b64efdc7b5a309b7e9a835d05821b49ac952f95166c7f992fae1b -size 263697 +oid sha256:aa0045621fcaf2551b46ccea4ee45c6734b25c128102aa574871a0f20b17460e +size 509880 diff --git a/docs/img/web-forms/geopoint-refining-accuracy.png b/docs/img/web-forms/geopoint-refining-accuracy.png index 7867c170a..a8fa0c8b5 100644 --- a/docs/img/web-forms/geopoint-refining-accuracy.png +++ b/docs/img/web-forms/geopoint-refining-accuracy.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:0774e977fc1311e56716fc2ee54ba62c146de92d7cee6e04e6411c8074bcbc7b -size 56237 +oid sha256:3f9d8dbc7cd1634df3a04fdfc22c9a324f31586a531eedee2c0e9b204fc12096 +size 193331 diff --git a/docs/img/web-forms/image-desktop.png b/docs/img/web-forms/image-desktop.png new file mode 100644 index 000000000..14a9ea3e9 --- /dev/null +++ b/docs/img/web-forms/image-desktop.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:58b8d2d4e04e6d746b19862d0687e12f42c32c4cd5c0f6be14d0d8d8825888ae +size 1530996 diff --git a/docs/web-forms-intro.rst b/docs/web-forms-intro.rst index a8bc2b3ae..795640e9a 100644 --- a/docs/web-forms-intro.rst +++ b/docs/web-forms-intro.rst @@ -1,7 +1,7 @@ Trying ODK Web Forms ==================== -ODK Central provides a web-based interface to your forms for data edits, to preview form definitions, and to enable data collection from devices other than Android phones. You can learn more about :ref:`how Central uses web-based forms `. +ODK Central provides a web-based interface to your forms for data edits, to preview form definitions, and to enable data collection from devices other than Android phones. You can learn about how Central uses web-based forms in :ref:`the section on managing Submissions `. By default, web forms in Central are powered by `Enketo `_, a powerful library that was initially developed outside the ODK project and that the ODK team has contributed to. @@ -17,12 +17,15 @@ Opting into ODK Web Forms in Central .. warning:: ODK Web Forms is experimental and does not support all form functionality! Please test your form carefully. -Starting in Central v2025.1.0, you can opt individual forms into using `ODK Web Forms `_, an experimental replacement for Enketo designed from the ground up to align with ODK Collect. ODK Web Forms is still early in its development. We recommend trying ODK Web Forms if: +Starting in Central v2025.1, you can opt individual forms into using `ODK Web Forms `_, an alternative to Enketo designed from the ground up to align with ODK Collect. ODK Web Forms is still early in its development. We recommend trying ODK Web Forms if: * You are curious about how web forms will evolve in Central. +* You like ODK Web Form's look and feel. * You want to provide feedback and ideas `on the forum `_. * You have a form that doesn't work well with Enketo. For example, this could be because of the presentation of certain question types such as ``geopoint``, performance issues, or bugs in repeats. +If you try your form draft, make some test submissions, and find that all of the functionality that you need is supported well, Web Forms can be used to collect real data. + To opt into ODK Web Forms, go to the :guilabel:`Settings` tab for a specific form. In the :guilabel:`Web Forms` section, select the :guilabel:`ODK Web Forms` option, read the description, and confirm that you want to opt in. You can see what functionality is currently supported `on Github `_. In particular, please note that the following sometimes subtle features are not yet supported: @@ -62,14 +65,19 @@ Once location permissions are granted to Web Forms, it will start reading locati .. image:: /img/web-forms/geopoint-refining-accuracy.* :alt: Web forms location-finding dialog - :class: central-partial-screen Image ~~~~~~~~ +.. image:: /img/web-forms/image-desktop.* + :class: central-partial-screen + The :ref:`image question type ` without appearance allows the user to capture an image. In Web Forms, if the user is on a mobile device, they can take a picture with their mobile camera. Devices like laptops that use a desktop browser will not show the capture button, even if they have a built-in camera. Date ~~~~~ +.. image:: /img/web-forms/calendar-yyyy-mm-dd.* + :class: central-partial-screen + The :ref:`date question type ` without appearance allows the user to enter a date. The user can manually type a date in the text field in the mm/dd/yyyy format or click in the field to select a date from a calendar. To change the year, they can press on the current year at the top of the calendar. To change the month, they can use the navigation arrows or press on the current month at the top of the calendar. There are also buttons to clear the date or jump to today. From 4520c0bcce38ee1e592811fa11d909f47cabd35b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?H=C3=A9l=C3=A8ne=20Martin?= Date: Mon, 5 May 2025 13:41:02 -0700 Subject: [PATCH 5/5] Fix --- docs/form-logic.rst | 2 +- docs/web-forms-intro.rst | 3 +++ 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/form-logic.rst b/docs/form-logic.rst index aad58c269..121ea7bc7 100644 --- a/docs/form-logic.rst +++ b/docs/form-logic.rst @@ -890,7 +890,7 @@ The labels are also shown in the jump menu. Filtering options in select questions =============================================== -To limit the options in a select or :doc:`rank ` question based on the answer to a previous question, specify an expression in the ``choice_filter`` column of the **survey** sheet. This choice filter expression must refer to one or more column in the **choices** sheet that the dataset should be filtered by. +To limit the options in a select or :ref:`rank ` question based on the answer to a previous question, specify an expression in the ``choice_filter`` column of the **survey** sheet. This choice filter expression must refer to one or more column in the **choices** sheet that the dataset should be filtered by. For example, you might ask your enumerators to select a state first, and then only display cities within that state. This is referred to as a "cascading select" and can be extended to any depth. The example below has two levels: job category and job title. diff --git a/docs/web-forms-intro.rst b/docs/web-forms-intro.rst index 795640e9a..fff6010f5 100644 --- a/docs/web-forms-intro.rst +++ b/docs/web-forms-intro.rst @@ -1,3 +1,6 @@ +.. spelling:word-list:: + yyyy + Trying ODK Web Forms ====================