cht-core icon indicating copy to clipboard operation
cht-core copied to clipboard

Prototype for Documenting UI State - Contacts Page | List View (Access)

Open lorerod opened this issue 5 months ago • 0 comments

Describe the issue We must create documentation for the UI State by Config. This will benefit the QA team, new team members, and first-time users of the cht. This issue aims to prototype one feature (for the Contacts Page | List View (Access)) to identify unknowns and create a workflow for documenting UI States.

Tasks already done

  • [X] Decide on the Feature:

We will use "Contacts Page - Access" as our first example.

  • [X] Confirm Individual Scenarios:

We will use this list of scenarios required for the "Contacts Page - Access."

  • [X] Design Configuration and Data:

Design the necessary configuration and data, including roles and names for households and other entities. We will start with this. As part of this work, we will improve the design if needed.

Tasks included in this issue

  • [ ] Create Tests for Screenshots:

    • [ ] Verify if existing end-to-end (e2e) tests cover the scenarios. If not, create new tests.

    • [ ] Update test data to be more realistic ("nice" data) if necessary for documentation purposes. If necessary, improve the design of the necessary configuration and data.

    • [ ] Run the tests to generate the required screenshots: Ensure the data and screenshots are consistent and realistic for documentation.

Tasks not included in this issue

  • [ ] Draft Documentation Pages:

Begin drafting the page(s) for the cht-docs repository. Include screenshots and detailed descriptions of each scenario.

  • [ ] Deploy to Docs Site:

Manually deploy the updated documentation and screenshots to the docs site.

lorerod avatar Aug 29 '24 20:08 lorerod