Pre-release Checklist v2.4.4

[jaykim1213]

Release Pull Request

• Confirm the release pull request targets main
• Confirm the pull request title exactly matches v2.4.4
• Confirm all required checks pass
• Confirm the pull request has the required approvals
• Confirm the release pull request preview deployed successfully
• Create the post-release checklist issue and link it here

Study Repository

Run Studies

Run each study in the release PR preview. Confirm it completes without unexpected errors and its participant data appears correctly in the analysis pages.

Demo Studies

• demo-html
• demo-html-input
• demo-form-elements
• demo-training
• demo-html-trrack
• demo-svelte-trrack
• demo-react-trrack
• demo-screen-recording
• demo-image
• demo-vega
• demo-video
• demo-dynamic
• demo-condition
• demo-style
• demo-yaml
• demo-ranking-widget
• demo-upset
• demo-choropleth-map

Example Studies

• example-VLAT-adaptive
• example-brush-interactions
• example-cleveland
• example-llm-chatbot
• example-mvnv

Tutorials

• tutorial
• tutorial-replication

Tests

• test-audio
• test-component-timeout
• test-device-restriction
• test-library
• test-likert-matrix
• test-parser-errors
• test-randomization
• test-skip-logic
• test-step-logic

Libraries

• library-adaptive-vlat
• library-beauvis
• library-berlin-num
• library-calvi
• library-color-blindness
• library-demographics
• library-graph-literacy-scale
• library-mic-check
• library-mini-vlat
• library-nasa-tlx
• library-previs
• library-quis
• library-sam
• library-screen-recording
• library-smeq
• library-sus
• library-ueq
• library-ueq-s
• library-umux
• library-umux-lite
• library-virtual-chinrest
• library-vlat

Analysis Pages

• Study Summary
  • Filter works correctly
  • Statistics look correct
• Participant View
  • Filter works correctly
  • Reject / Undo reject participant works correctly
  • Replay timeline looks correct
• Replay
  • Replay works correctly at different play speeds
  • Check provenance data (audio, screen, etc.)
  • Navigate to the next and previous participant IDs
  • Add participant tags
  • Navigate to the next and previous participant tasks
  • Add task tags
  • Load transcripts (e.g. demo-screen-recording)
  • Download audio/screen recordings (e.g. demo-screen-recording)
  • Reject / Undo reject participant works correctly
• Trial Stats
  • Filter works correctly
  • Overview stats look correct
  • Vega stimulus for answers looks correct
• Coding
  • Filter works correctly
  • Add text tags
  • Add annotations
  • Replay works correctly at different play speeds
  • Navigate to the next and previous participant IDs
  • Add participant tags
  • Navigate to the next and previous participant tasks
  • Add task tags
  • Load transcripts (e.g. demo-screen-recording)
  • Download audio/screen recordings (e.g. demo-screen-recording)
  • Reject / Undo reject participant works correctly
• Live Monitor
  • Filter works correctly
  • Check participant count header
  • Check live monitor tracker
• Config
  • Filter works correctly
  • Download configs (by selecting from the table) / Download config (single download from actions column)
  • Compare configs
  • View config
• Manage
  • Changing ReVISit Modes updates the study card and study browser
  • Add a new stage and edit stage color
  • Create a data snapshot
  • Confirm Manage is only accessible to administrators
• File download
  • JSON export
  • Tidy download export
  • Download audio recordings
  • Download screen recordings
  • Download provenance data
• Change study from the study dropdown
• Click Go to study and confirm it opens the study

Generated Files

• If parser types changed, regenerate the study config schemas using yarn generate-schemas
• If libraries changed, regenerate library documentation and example studies using yarn generate-library-docs and yarn generate-library-examples

Documentation

• Update comments in store/types.ts, parser/types.ts, storage/types.ts, storage/engines/types.ts
• Update typedocReadMe.md
• Verify documentation links in the Study Repository are up-to-date and point to the current reVISit documentation pages

Documentation Repository

• Update documentation for release changes
• Update screenshots
• Review documentation for accuracy, typos, outdated content, and expired links
• Review library list
• Check the adoption Google Form for newly published papers
• Validate example code

ReVISitPy Repository

• If parser types or schemas changed, confirm they are compatible with ReVISitPy code generation

TODOs

Create or link any release-blocking issues or bugs found during release QA.
Add any other tasks that must be completed before the release.

• Fix broken links reVISit-studies.github.io#248