Skip to content

docs: [DHIS2-20703] Fix typos and grammar in using-the-capture-app.md#4533

Draft
karolinelien wants to merge 3 commits into
masterfrom
fix/DHIS2-20703-documentation-typos
Draft

docs: [DHIS2-20703] Fix typos and grammar in using-the-capture-app.md#4533
karolinelien wants to merge 3 commits into
masterfrom
fix/DHIS2-20703-documentation-typos

Conversation

@karolinelien
Copy link
Copy Markdown
Contributor

@karolinelien karolinelien commented Apr 29, 2026

What is fixed?

Comprehensive cleanup of docs/user/using-the-capture-app.md based on DHIS2-20703.


Typos & spelling (15 fixes — committed earlier)

Line Was Fixed
273 enrollement enrollment
304 pre-fielded pre-filled
304 teId teiID
340 attibutes attributes
431 draging dragging
451 fitered filtered
451 rang range
675 the the the
744 entitiy entity
744 retrurned returned
796 the the the
796 reorgainze reorganize
947 ###Quick actions ### Quick actions
1172 informations related with information related to
1287 cumpute compute

Outdated content & UI description updates

  • Sort arrows (event list + TEI list): Updated text from "small upward/downward arrow" to describe the new dual up/down arrows UI, where the active direction is highlighted and unsorted columns show both greyed out
  • Column layout (TEI list): Updated text to mention the six-dot drag handle on the left side of each column name
  • Enrollment dashboard URL: Fixed outdated .../dhis-web-capture/#/enrollment?enrollmentId=... to ../capture#/enrollment?enrollmentId=...

Missing or incomplete documentation

  • Relationships: Removed outdated claim that Capture only supports Event-to-TEI relationships. Now documents that TEI-to-TEI and other configured types are also supported
  • User assignment: Added how to enable the feature (Enable user assignment of events in Maintenance app program settings)
  • Search results — View dashboard vs View active enrollment: Added explanation of the difference: "View dashboard" opens the most recent enrollment across all programs; "View active enrollment" opens the enrollment in the program currently being searched
  • Re-enroll option: Added note that the option only appears when the existing enrollment is complete
  • Transfer enrollment: Added paragraph explaining that transfer changes the owning organisation unit, affects data visibility/access, and does not move historical event data
  • Related stages: Added practical workflow examples (lab request → lab result, referral → follow-up) to explain the use case
  • Related stages TOC: Added { #anchor-id } attributes to the # Related stages and linked events section and all its ## subsections so they appear in the docs site table of contents

Screenshots that still need manual replacement

These image files need to be replaced with updated screenshots — not possible to automate without a live DHIS2 instance:

Image Section What changed
resources/images/sort_event.png Sort an event list Single down-arrow → dual up/down arrows
resources/images/tei_list_sort_order.png Sort the list (TEI list) Same arrow UI change
resources/images/tei_list_column_layout.png Modify the list layout Reorganize button now shows 6-dot handle on left
resources/images/modify_event_list.png Modify event list layout Same 6-dot column handle change
resources/images/enrollment-dash-01.png Reaching enrollment dashboard via URL Shows v2.37 UI with old URL structure
Enrollment dashboard section images (general) Enrollment dashboard Most images need updating to current UI

DHIS2-20703

Generated with Claude Code

Fixes 15 issues: enrollment, pre-filled, teiID, attributes, dragging,
filtered, range, duplicate 'the', entity, returned, reorganize,
heading spacing, information/related-to, compute.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@karolinelien karolinelien requested review from a team as code owners April 29, 2026 14:02
@karolinelien karolinelien marked this pull request as draft April 29, 2026 14:07
karolinelien and others added 2 commits April 30, 2026 10:07
…anchors

- Relationships: remove outdated 'only supports Event to TEI' claim;
  document that TEI-to-TEI and other types are now supported
- User assignment: clarify that the feature is enabled via 'Enable user
  assignment of events' in Maintenance app program settings
- Search results: explain difference between 'View dashboard' (most
  recent enrollment across programs) vs 'View active enrollment'
  (active enrollment in current program)
- Re-enroll: add note that option only appears when enrollment is complete
- Transfer enrollment: document that transfer changes owning org unit,
  affects data visibility, and does not move historical event data
- Sort arrows: update text to describe dual up/down arrows (replacing
  single-arrow description) in both event list and TEI list sections
- Column layout: update text to describe 6-dot drag handle on left
- URL: fix outdated dhis-web-capture/#/ path to ../capture#/
- Related stages: add practical workflow examples (lab request/result,
  referral/follow-up) and add { #anchor-id } to all section headers so
  the section appears in the docs site table of contents

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@cooper-joe cooper-joe force-pushed the fix/DHIS2-20703-documentation-typos branch from 3ae5fcf to bbc0200 Compare April 30, 2026 08:09
### Top bar context

At the top of the page you can see different informations related with the current context. You can see the program, the organization unit, the tracked entity, the enrollment date, the stage.
At the top of the page you can see different information related to the current context. You can see the program, the organization unit, the tracked entity, the enrollment date, the stage.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: organization -> organisation - but could probably do a full check of all our documentation and find inconsistent usage of one or the other.

@sonarqubecloud
Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants