RC Test: Projectile Sampling Distributions 1.0.7-rc.3 + CODAP

Mar 12, 2025 by ADMIN 62 views

Mentions: @KatieWoe @Nancy-Salpepi @catherinecarter @zepumph @kathy-phet

Introduction

This is a comprehensive test plan for the Projectile Sampling Distributions 1.0.7-rc.3 simulation, which includes the CODAP integration. The test plan covers various features and functionalities of the simulation, including data collection, variable checking, and attribute manipulation. The test plan also includes a list of issues to verify and a set of general features to test.

Simulation Links

Test Matrices

Features Included

[x] PhET-iO
[x] Dynamic Locale
[x] Alternative Input
[x] UI Sound
[x] Sonification
[ ] Description
[ ] Voicing

Focus and Special Instructions

Please test both wrappers: 'data-activity' and 'sample-activity'. 'data-activity' is the same design as previous RC's, while 'sample-activity' collected one row of data per sample (collected when the last projectile in that sample lands).

For each wrapper, please test the following features:

Collecting data for each of the available variables
Checking and unchecking variables in the sidebar menu attached to the sim
Dragging variables from the CODAP table into different spots in the table
Dragging variables from the CODAP table to form higher-order groups of data (including multiple levels of nested data groupings)
Checking/unchecking variables after some data has already been collected
Data should not be collected for a variable unless its box is checked when the projectile (or last projectile in the sample) lands
Various combinations of the above
Manually hiding attributes using the CODAP table (click attribute name, then 'Hide Attribute')
Manually renaming attributes using the CODAP table (click attribute name, then 'Rename Attribute')
Collecting data and combinations of the first 5 steps after manually hiding or renaming attributes
Confirm that clicking save/export/make a copy in the CODAP menu will save the entire combined state of the sim + CODAP integration
Collecting batches of data using the 'Auto-generate Data' sim preference

Issues to Verify

These issues should have the "status:ready-for-review" label. Unless an issue says to close after verifying, assign the issue back to the developer.

General Features

What to Test

Click every single button.
Test all possible forms of input.
- Test all mouse/trackpad inputs.
- Test all touchscreen inputs.
If there is sound, make sure it works.
Make sure you can't lose anything.
Play with the sim normally.
Try to break the sim.
Test all query parameters on all platforms. (See QA Book for a list of query parameters.)
Download HTML on Chrome and iOS.
Make sure the iFrame version of the simulation is working as intended on all platforms.
Make sure the XHTML version of the simulation is working as intended on all platforms.
Complete the test matrix.
Don't forget to make sure the sim works with Legends of Learning.
Test the Game Up harness on at least one platform.
Check this LoL spreadsheet and notify AR or AM if it not there.
If this is rc.1 please do a memory test.
When making an issue, check to see if it was in a previously published version.
Try to include version numbers for browsers.
If there is a console available, check for errors and include them in the Problem Description.
As an RC begins and ends, check the sim repo. If there is a maintenance issue, check it and notify developers if there is a problem.
As the RC ends, please review the QA credits in the about dialog. If the QA credits are complete and correct, please add a comment in the RC test issue indicating so. If not, please open a new issue and specify what changes should be made.

PhET-iO RC Features

What to Test

Make sure that public files do not have password protection. Use a private browser for this.
Make sure that private files do have password protection. Use a private browser for this.
Make sure standalone sim is working properly.
Make sure the wrapper index is working properly.
Make sure each wrapper is working properly.
Launch the simulation in Studio with ?stringTest=xss and make sure the sim doesn't navigate to youtube
For newer PhET-iO wrapper indices, save the "basic example of a functional wrapper" as a .html file and open it. Make sure the simulation loads without crashing or throwing errors.
Load the login wrapper just to make sure it works. Do so by adding this link from the sim deployed root:

/wrappers/login/?wrapper=record&validationRule=validateDigits&&numberOfDigits=5&promptText=ENTER_A_5_DIGIT_NUMBER

Further instructions in QA Book

Conduct a recording test to Metacog, further instructions in the QA Book. Do this for iPadOS + Safari and one other random platform.
Conduct a memory test on the stand alone sim wrapper (rc.1).
Test one platform combination with ?phetioDebug=true on the Studio and State wrapper.
If Pan/Zoom is supported, make sure that it works when set with PhET-iO State.
Test that the sim works offline:
- Click the link to the phet-io zip file (at top of issue) to download the zip file.
- Unzip it to a spot locally.
- Open index.html by double clicking it on your desktop or in a Finder-view.
- It should look like the standalone version of the sim in PhET-iO brand.

Accessibility Features

What to Test

Specific instructions can be found above.
Make sure the accessibility (a11y) feature that is being tested doesn't negatively affect the sim in any way. Here is a list of features that may be supported in this test:
- Alternative Input
- Interactive Description
- Sound and Sonification
- Pan and Zoom
- Mobile Description
- Voicing
Test all possible forms of input.
- Test all mouse/trackpad inputs.
- Test all touchscreen inputs.
- Test all keyboard navigation inputs (if applicable).
- Test all forms of input with a screen reader (if applicable).
If this sim is not in this list or up to date there, make an issue in website to ask if PhET research page links need updating. Please assign to @terracoda and @emily-phet.

Screen Readers

This sim may support screen readers. If you are unfamiliar with screen readers, please ask Katie to introduce you to screen readers. If you simply need a refresher on screen readers, please consult the QA Book, which should have all of the information you need as well as a link to a screen reader tutorial made by Jesse. Otherwise, look over the a11y view before opening the simulation. Once you've done that, open the simulation and make sure alerts and descriptions work as intended.

Platforms and Screen Readers to Be Tested

Windows 10 + Latest Chrome + Latest JAWS
Windows 10 + Latest Firefox + Latest NVDA
macOS + Safari + VoiceOver
iOS + Safari + VoiceOver (only if specified in testing issue)

Critical Screen Reader Information

We are tracking known screen reader bugs in here. If you find a screen reader bug, please check it against this list.

Keyboard Navigation

This sim supports keyboard navigation. Please make sure it works as intended on all platforms by itself and with a screen reader.

Magnification

Frequently Asked Questions

Q: What is the purpose of this test plan?

A: The purpose of this test plan is to ensure that the Projectile Sampling Distributions 1.0.7-rc.3 simulation, which includes the CODAP integration, is thoroughly tested and meets the required standards.

Q: What features are included in this test plan?

A: This test plan includes the following features:

PhET-iO
Dynamic Locale
Alternative Input
UI Sound
Sonification
Description
Voicing

Q: What are the specific instructions for testing the simulation?

A: Please test both wrappers: 'data-activity' and 'sample-activity'. 'data-activity' is the same design as previous RC's, while 'sample-activity' collected one row of data per sample (collected when the last projectile in that sample lands).

For each wrapper, please test the following features:

Collecting data for each of the available variables
Checking and unchecking variables in the sidebar menu attached to the sim
Dragging variables from the CODAP table into different spots in the table
Dragging variables from the CODAP table to form higher-order groups of data (including multiple levels of nested data groupings)
Checking/unchecking variables after some data has already been collected
Data should not be collected for a variable unless its box is checked when the projectile (or last projectile in the sample) lands
Various combinations of the above
Manually hiding attributes using the CODAP table (click attribute name, then 'Hide Attribute')
Manually renaming attributes using the CODAP table (click attribute name, then 'Rename Attribute')
Collecting data and combinations of the first 5 steps after manually hiding or renaming attributes
Confirm that clicking save/export/make a copy in the CODAP menu will save the entire combined state of the sim + CODAP integration
Collecting batches of data using the 'Auto-generate Data' sim preference

Q: What issues should be verified?

A: The following issues should be verified:

Q: What are the general features to test?

A: The following general features should be tested:

Click every single button.
Test all possible forms of input.
- Test all mouse/trackpad inputs.
- Test all touchscreen inputs.
If there is sound, make sure it works.
Make sure you can't lose anything.
Play with the sim normally.
Try to break the sim.
Test all query parameters on all platforms. (See QA Book for a list of query parameters.)
Download HTML on Chrome and iOS.
Make sure the iFrame version of the simulation is working as intended on all platforms.
Make sure the XHTML version of the simulation is working as intended on all platforms.
Complete the test matrix.
Don't forget to make sure the sim works with Legends of Learning.
Test the Game Up harness on at least one platform.
Check this LoL spreadsheet and notify AR or AM if it not there.
If this is rc.1 please do a memory test.
When making an issue, check to see if it was in a previously published version.
Try to include version numbers for browsers.
If there is a console available, check for errors and include them in the Problem Description.
As an RC begins and ends, check the sim repo. If there is a maintenance issue, check it and notify developers if there is a problem.
As the RC ends, please review the QA credits in the about dialog. If the QA credits are complete and correct, please add a comment in the RC test issue indicating so. If not, please open a new issue and specify what changes should be made.

Q: What are the PhET-iO RC features to test?

A: The following PhET-iO RC features should be tested:

Make sure that public files do not have password protection. Use a private browser for this.
Make sure that private files do have password protection. Use a private browser for this.
Make sure standalone sim is working properly.
Make sure the wrapper index is working properly.
Make sure each wrapper is working properly.
Launch the simulation in Studio with ?stringTest=xss and make sure the sim doesn't navigate to youtube
For newer PhET-iO wrapper indices, save the "basic example of a functional wrapper" as a .html file and open it. Make sure the simulation loads without crashing or throwing errors.
Load the login wrapper just to make sure it works. Do so by adding this link from the sim deployed root:

/wrappers/login/?wrapper=record&validationRule=validateDigits&&numberOfDigits=5&promptText=ENTER_A_5_DIGIT_NUMBER

Further instructions in QA Book

Conduct a recording test to Metacog, further instructions in the QA Book. Do this for iPadOS + Safari and one other random platform.
Conduct a memory test on the stand alone sim wrapper (rc.1).
Test one platform combination with ?phetioDebug=true on the Studio and State wrapper.
If Pan/Zoom is supported, make sure that it works when set with PhET-iO State.
Test that the sim works offline:
- Click the link to the phet-io zip file (at top of issue) to download the zip file.
- Unzip it to a spot locally.
- Open index.html by double clicking it on your desktop or in a Finder-view.
- It should look like the standalone version of the sim in PhET-iO brand.

Q: What are the accessibility features to test?

A: The following accessibility features should be tested:

Specific instructions can be found above.
Make sure the accessibility (a11y) feature that is being tested doesn't negatively affect the sim in any way. Here is a list of features that may be supported in this test:
- Alternative Input
- Interactive Description
- Sound and Sonification
- Pan and Zoom
- Mobile Description
- Voicing
Test all possible forms of input.
- Test all mouse/trackpad inputs.
- Test all touchscreen inputs.
- Test all keyboard navigation inputs (if applicable).
- Test all forms of input with a screen reader (if applicable).
If this sim is not in this list or up to date there, make an issue in website to ask if PhET research page links need updating. Please assign to @terracoda and @emily-phet.

Q: What are the screen readers to test?

A: The following screen readers should be tested:

Windows 10 + Latest Chrome + Latest JAWS
Windows 10 + Latest Firefox + Latest NVDA
macOS + Safari + VoiceOver
iOS + Safari + VoiceOver (only if specified in testing issue)

Q: What are the critical screen reader information?

A: We are tracking known screen reader bugs in here. If you find a screen reader bug, please check it against this list.

Q: What are the keyboard navigation features to test?

A: The following keyboard navigation features should be tested:

This sim supports keyboard navigation. Please make sure it works as intended on all platforms by itself and with a screen reader.

Q: What are the magnification features to test?

A: The following magnification features should be tested:

This sim supports magnification with pinch and drag gestures on touch screens, keyboard shortcuts, and