Suggested changes to examples.md

[Nancy-Salpepi]

For phetsims/qa#1105, in the examples.md the current directions for hiding the kick button are incorrect (or I am interpreting them incorrectly).

This is what I did:

1. Kicked 3 balls
2. Set Max Property to 3 --> the kicked balls disappear and the Kick button is still present.

If you flip the 2 steps, then the Kick Button won't be there.

[Nancy-Salpepi]

For this section I think it would be helpful to first have a step about setting the predictMeanVisibleProperty to True before setting its location and hiding the pencil:

[Nancy-Salpepi]

This one is for @marlitas:

Please feature:
meanShareAndBalance.distributeScreen.model.meanPredictionProperty
meanShareAndBalance.distributeScreen.view.meanPredictionLine.meanPredictionHandle.visibleProperty

EDIT: here's one more:
meanShareAndBalance.balancePointScreen.model.sceneModel.kickDistributionStrategy

They are currently listed in the examples.md, but not featured.

[Nancy-Salpepi]

In the section "Determine if the notepad is displaying the mean" for the Balance Point Screen, change meanPropertyValue to meanValueProperty

[amanda-phet]

Thanks @Nancy-Salpepi ! I think all of those things look good now, if you want to take a peek (looking at the commit will make it easy to see the changes).

@marlitas can you please feature these elements:

• meanShareAndBalance.distributeScreen.model.meanPredictionProperty
• meanShareAndBalance.distributeScreen.view.meanPredictionLine.meanPredictionHandle.visibleProperty
• meanShareAndBalance.balancePointScreen.model.sceneModel.kickDistributionStrategy

[marlitas]

This is ready for review by @amanda-phet and @Nancy-Salpepi

[amanda-phet]

Thanks @marlitas those look good to me.

@Nancy-Salpepi please feel free to close after you've reviewed examples.md to be sure it looks clear to you.

[Nancy-Salpepi]

@amanda-phet just wanted to note that this can also be done by direct interaction with the sim (using the number spinner):

Hide the Kick button
The visibilily of the Kick button is determined by whether there are any balls available to be kicked. The button can be hidden using maxKicksProperty: first set maxKicksProperty to the desired number, then kick all balls onto the field.
meanShareAndBalance.balancePointScreen.model.maxKicksProperty

Also, would an instructor still want students to be able to use the decrement button afterwards? This would make the Kick button reappear. Not sure what the learning goal is.

[Nancy-Salpepi]

Everything else looks good on main.

[amanda-phet]

I added that extra note about how to kick the balls. I don't think we need to go into hiding the number spinner. Nodes have a visibleProperty, but the kick button does not because its visibility is controlled by the last ball being kicked, so that's why it has special instructions. Thanks for your review!