RC Spot-Check Test: Balancing Chemical Equations 2.0.0-rc.2

by ADMIN 60 views

Mentions

@KatieWoe, @kathy-phet

Simulation links

Test Matrices

General Test

  • Tester = , Platform = , Time =
  • Tester = , Platform = , Time =

PhET-iO Test

  • Tester = , Platform = , Time =
  • Tester = , Platform = , Time =

Additional Features Test

  • Tester = , Platform = , Time =
  • Tester = , Platform = , Time =

Features included

  • PhET-iO - new for this version
  • Dynamic Locale - first included in 1.3 on 11/24/25
  • Alternative Input
  • UI Sound - first included in 1.3 on 11/24/25
  • Sonification
  • Description
  • Voicing

Focus and Special Instructions

This is the first PhET-iO release, so comparing with the previous version is irrelevant.

  • [ ] Please check the QA credits and open a new issue if anything needs to be updated.

Issues to Verify

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

For QA...

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 some query parameters. (See QA Book for a list of query parameters.)
  • 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, notify the developer of any new QA credits that need to be added.

PhET-iO 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 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

This sim supports magnification with pinch and drag gestures on touch screens, keyboard shortcuts, and mouse/wheel controls. Please test magnfication and make sure it is working as intended and well with the use cases of the simulation. Due to the way screen readers handle user input, magnification is NOT expected to work while using a screen reader so there is no need to test this case.

FAQs for QA Members

There are multiple tests in this issue... Which test should I do first?

Test in order! Test the first thing first, the second thing second, and so on.

How should I format my issue?

Here's a template for making issues:

  <b>Test Device</b>

  blah

  <b>Operating System</b>

  blah

  <b>Browser</b>

  blah

  <b>Problem Description</b>

  blah

  <b>Steps to Reproduce</b>

  blah

  <b>Visuals</b>

  blah

  <details>
  <summary><b>Troubleshooting Information</b></summary>

  blah

  </details>

Who should I assign?

We typically assign the developer who opened the issue in the QA repository.

My question isn't in here... What should I do?

You should:

  1. Consult the QA Book.
  2. Google it.
  3. Ask Katie.
  4. Ask a developer.
  5. Google it again.
  6. Cry.

General Questions

Q: What is the purpose of this RC Spot-Check Test?

A: The purpose of this RC Spot-Check Test is to ensure that the Balancing Chemical Equations 2.0.0-rc.2 simulation is functioning correctly and meets the required standards.

Q: Who should I contact if I have any questions or concerns?

A: If you have any questions or concerns, please contact Katie or Kathy-phet. They will be happy to assist you.

Q: What is the deadline for completing this test?

A: The deadline for completing this test is not specified. However, it is recommended that you complete the test as soon as possible to ensure that the simulation is ready for release.

Test-Specific Questions

Q: What are the specific tests that need to be performed?

A: The specific tests that need to be performed are listed in the Test Matrices section of this document. These tests include the General Test, PhET-iO Test, and Additional Features Test.

Q: What are the requirements for the PhET-iO Test?

A: The requirements for the PhET-iO Test include ensuring that public files do not have password protection, private files do have password protection, and the standalone sim is working properly.

Q: What are the requirements for the Accessibility Test?

A: The requirements for the Accessibility Test include ensuring that the simulation is accessible to users with disabilities, including those who use screen readers.

Technical Questions

Q: What is the difference between a PhET-iO wrapper and a standalone sim?

A: A PhET-iO wrapper is a version of the simulation that is designed to work with the PhET-iO platform, while a standalone sim is a version of the simulation that can be run independently.

Q: What is the purpose of the ?phetioDebug=true query parameter?

A: The ?phetioDebug=true query parameter is used to enable debugging mode for the PhET-iO wrapper.

Q: How do I test the simulation offline?

A: To test the simulation offline, you can download the phet-io zip file, unzip it to a local location, and open the index.html file in a web browser.

Troubleshooting Questions

Q: What should I do if I encounter an error while testing the simulation?

A: If you encounter an error while testing the simulation, please report it to Katie or Kathy-phet, along with any relevant error messages or screenshots.

Q: How do I troubleshoot issues with the PhET-iO wrapper?

A: To troubleshoot issues with the PhET-iO wrapper, please refer to the PhET-iO documentation and troubleshooting guides.

Additional Resources

Q: Where can I find additional resources and documentation for the Balancing Chemical Equations simulation?

A: Additional resources and documentation for the Balancing Chemical Equations simulation can be found on the PhET-iO website and in the simulation's documentation.

Q: Where can I find information on how to use the PhET-iO platform?

A: Information on how to use the PhET-iO platform can be found on the PhET-iO website and in the platform's documentation.