From 0b97c21cccf45932d33e4771602db35ce36949be Mon Sep 17 00:00:00 2001 From: latin-panda <66472237+latin-panda@users.noreply.github.com> Date: Sat, 20 Dec 2025 00:53:13 +0700 Subject: [PATCH 1/4] update docs for wf --- docs/web-forms-intro.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/web-forms-intro.rst b/docs/web-forms-intro.rst index e4c72d9e7..f60512f5d 100644 --- a/docs/web-forms-intro.rst +++ b/docs/web-forms-intro.rst @@ -49,8 +49,8 @@ b-forms?tab=readme-ov-file#feature-matrix>`_. While most supported functionality Web Forms currently supports 3 geo question types and appearances: * :ref:`Geopoint ` -* :ref:`Maps appearance ` -* :ref:`Placement-map appearance ` +* :ref:`Maps appearance ` +* :ref:`Placement-map appearance ` **Coming soon** From 1bec0a99b9ca16ca24171aadfa943a4dbd0e908e Mon Sep 17 00:00:00 2001 From: latin-panda <66472237+latin-panda@users.noreply.github.com> Date: Sat, 20 Dec 2025 00:58:17 +0700 Subject: [PATCH 2/4] fixes links --- docs/web-forms-intro.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/web-forms-intro.rst b/docs/web-forms-intro.rst index f60512f5d..e4c72d9e7 100644 --- a/docs/web-forms-intro.rst +++ b/docs/web-forms-intro.rst @@ -49,8 +49,8 @@ b-forms?tab=readme-ov-file#feature-matrix>`_. While most supported functionality Web Forms currently supports 3 geo question types and appearances: * :ref:`Geopoint ` -* :ref:`Maps appearance ` -* :ref:`Placement-map appearance ` +* :ref:`Maps appearance ` +* :ref:`Placement-map appearance ` **Coming soon** From 1e6a9a13defa844fa35aba7c6501f62fb3f12028 Mon Sep 17 00:00:00 2001 From: latin-panda <66472237+latin-panda@users.noreply.github.com> Date: Sat, 20 Dec 2025 01:07:35 +0700 Subject: [PATCH 3/4] update docs --- docs/img/web-forms/geoshape.png | 3 +++ docs/img/web-forms/geotrace.png | 3 +++ docs/web-forms-intro.rst | 34 ++++++++++++++++++++++++++------- 3 files changed, 33 insertions(+), 7 deletions(-) create mode 100644 docs/img/web-forms/geoshape.png create mode 100644 docs/img/web-forms/geotrace.png diff --git a/docs/img/web-forms/geoshape.png b/docs/img/web-forms/geoshape.png new file mode 100644 index 000000000..dc82df64e --- /dev/null +++ b/docs/img/web-forms/geoshape.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:0807273d325b5410520126e5353271e8531d0b3b4572d195539e90be3f2fb774 +size 2208736 diff --git a/docs/img/web-forms/geotrace.png b/docs/img/web-forms/geotrace.png new file mode 100644 index 000000000..70fbb4b8b --- /dev/null +++ b/docs/img/web-forms/geotrace.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:eabec39687d7d0979702e7ebd50ba8b0b9a97d2a43ccdfab6743d26ac080ec28 +size 1532671 diff --git a/docs/web-forms-intro.rst b/docs/web-forms-intro.rst index e4c72d9e7..b13dd9f45 100644 --- a/docs/web-forms-intro.rst +++ b/docs/web-forms-intro.rst @@ -46,17 +46,13 @@ 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. -Web Forms currently supports 3 geo question types and appearances: +Web Forms currently supports 5 geo question types and appearances: * :ref:`Geopoint ` * :ref:`Maps appearance ` * :ref:`Placement-map appearance ` - -**Coming soon** - -- Geoshape -- Geotrace -- Editing all map appearances +* :ref:`Geoshape ` +* :ref:`Geotrace ` Geopoint without appearance ~~~~~~~~ @@ -95,6 +91,30 @@ For both `maps` and `placement-map` appearances, location capture stops when the .. image:: /img/web-forms/geopoint-placement-map-appearance.* :alt: Web forms geopoint with placement-map appearance +Geoshape +~~~~~~~~ + +The geoshape question type allows users to capture a polygon area on a map by adding at least three points to form a closed shape. + +The status bar shows `No points saved` when having less than 3 points. Long press to add points; the shape closes automatically and autosaves, updating the status bar (e.g., `4 points saved`). The last point is highlighted in a darker tone and it’s larger. Long press to drag and move points. + +Select the shape to delete entirely (with confirmation); select a vertex to delete it (no confirmation). Tap off the shape to deselect; tap to reselect with vertices shown. Undo reverts the last change. + +.. image:: /img/web-forms/geoshape.* + :alt: Web forms geoshape + +Geotrace +~~~~~~~~ + +The geotrace question type allows users to capture a line on a map by adding at least two points. + +The status bar shows `No points saved` when having less than 2 points. Long press to add points; autosaves continuously, updating the status bar (e.g., `3 saved points`). The last point is highlighted in a darker tone and it’s larger. Long press to drag and move points. + +Select the trace to delete entirely (with confirmation); select a vertex to delete it (no confirmation). Tap off the line to deselect; tap to reselect with vertices shown. Undo reverts the last change. + +.. image:: /img/web-forms/geotrace.* + :alt: Web forms geotrace + Image ~~~~~~~~ From 08f6e12924a73de5bc4999445b043945d22ff7be Mon Sep 17 00:00:00 2001 From: latin-panda <66472237+latin-panda@users.noreply.github.com> Date: Sat, 20 Dec 2025 01:20:40 +0700 Subject: [PATCH 4/4] spelling --- docs/web-forms-intro.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/web-forms-intro.rst b/docs/web-forms-intro.rst index b13dd9f45..e802746b0 100644 --- a/docs/web-forms-intro.rst +++ b/docs/web-forms-intro.rst @@ -96,9 +96,9 @@ Geoshape The geoshape question type allows users to capture a polygon area on a map by adding at least three points to form a closed shape. -The status bar shows `No points saved` when having less than 3 points. Long press to add points; the shape closes automatically and autosaves, updating the status bar (e.g., `4 points saved`). The last point is highlighted in a darker tone and it’s larger. Long press to drag and move points. +The status bar shows `No points saved` when having fewer than 3 points. Long-press to add points; the shape closes automatically and auto-saves, updating the status bar (e.g., `4 points saved`). The last point is highlighted in a darker tone, and it’s larger. Long-press to drag and move points. -Select the shape to delete entirely (with confirmation); select a vertex to delete it (no confirmation). Tap off the shape to deselect; tap to reselect with vertices shown. Undo reverts the last change. +Select the shape to delete entirely (with confirmation); select a vertex to delete it (no confirmation). Tap off the shape to deselect. Undo reverts the last change. .. image:: /img/web-forms/geoshape.* :alt: Web forms geoshape @@ -108,9 +108,9 @@ Geotrace The geotrace question type allows users to capture a line on a map by adding at least two points. -The status bar shows `No points saved` when having less than 2 points. Long press to add points; autosaves continuously, updating the status bar (e.g., `3 saved points`). The last point is highlighted in a darker tone and it’s larger. Long press to drag and move points. +The status bar shows `No points saved` when having fewer than 2 points. Long-press to add points; auto-saves continuously, updating the status bar (e.g., `3 saved points`). The last point is highlighted in a darker tone, and it’s larger. Long-press to drag and move points. -Select the trace to delete entirely (with confirmation); select a vertex to delete it (no confirmation). Tap off the line to deselect; tap to reselect with vertices shown. Undo reverts the last change. +Select the trace to delete entirely (with confirmation); select a vertex to delete it (no confirmation). Tap off the line to deselect. Undo reverts the last change. .. image:: /img/web-forms/geotrace.* :alt: Web forms geotrace