examples.md

[pixelzoom]

I'll create an empty examples.md, then assign to @arouinfar to populate.

[pixelzoom]

The empty examples.md is https://github.com/phetsims/phet-io-sim-specific/blob/master/repos/acid-base-solutions/examples.md

[pixelzoom]

From https://github.com/phetsims/acid-base-solutions/issues/178#issuecomment-1360622707:

• [ ] Some views are optimized to update only when they're visible, so will not be in sync with the model when invisible. Is that a problem for PhET-iO? This includes:
  • PHPaperNode color
  • MagnifyingGlassNode particles
  • ConcentrationGraphNode bars and values

We decided that this was OK, and necessary to keep the sim responsive. But it should be mentioned in examples.md.

[pixelzoom]

Strong acids and bases are modeled as having constant strength. The value is arbitrarily chosen to be 101. It only needs to be greater than the maximum strength of weak acids and bases.

[pixelzoom]

All non-Water solutions in the Intro screen have concentration 1E-2. You'll need to change each solution individually if you want them all to be the same. The elements are:

acidBaseSolutions.introductionScreen.model.solutions.strongAcid.concentrationProperty acidBaseSolutions.introductionScreen.model.solutions.strongBase.concentrationProperty acidBaseSolutions.introductionScreen.model.solutions.weakAcid.concentrationProperty acidBaseSolutions.introductionScreen.model.solutions.weakBase.concentrationProperty

[arouinfar]

Thanks for adding this information @pixelzoom! I'll use this comment to keep a running list of additional things to document.

• [x] To completely hide the tools, set toolModeProperty to none and hide the RadioButtonGroup, see #206
• [x] Hide the strength slider, see #185
• [x] Customizing stock solutions on Intro screen (concentration, strength for weak acid/bases)
• [x] pH Paper color can be customized #215
• [x] pH Paper color values for data table #216
• [x] Customizing the graph, including hiding values, #221
• [x] Preferences, #220

Tagging #190 so this issue shows up there.

[arouinfar]

I've completed a first draft of examples.md. @Nancy-Salpepi can you please take a look and let me know if you have any recommendations?

[Nancy-Salpepi]

Examples look good @arouinfar!

• [x] One thing I thought about while going through my AP notes was including something about how to get the values for calculating percent ionization (typically done for weak acids as another way of comparing strength).
• [x] Also, should we include hiding the equation in the examples?
• [x] Lastly, I would change the wording for this sentence under Customize Solutions > My Solutions Screen:

If there are values you want to be kept constant, use visibleProperty to hide the control or enabledProperty to disable it.

Maybe change the wording at the beginning of this sentence? "If you want to keep certain values constant..."

[arouinfar]

Thanks for your feedback @Nancy-Salpepi. I've made the requested changes in the above commit. The examples doc is now complete, closing.