code-dot-org / ml-activities

This is the repo for AI for Oceans from Code.org.
https://code-dot-org.github.io/ml-activities/
Apache License 2.0
5 stars 7 forks source link

Guides variant: K5 #402

Closed breville closed 3 months ago

breville commented 4 months ago

With this change, AI for Oceans supports a new variant of guides for some new K-5 curriculum. This means that the tutorial can still run unchanged from its original form as an Hour of Code tutorial, but the curriculum team can author a new set of guide messages, for the same modes as before, for new K-5 curriculum.

For now, this can be authored by running locally with URLs like the following:

The original Hour of Code guides are now in guidesHoc.js, and should remain unchanged for now. The new guides duplicate this set, with one example text change, in guidesK5.js, which can now be modified by the curriculum team.

breville commented 4 months ago

What is the imagined way for curriculum writers to update this. Strings really need to be added to https://github.com/code-dot-org/ml-activities/blob/main/i18n/oceans.json, then use the I18n.t function to call them. Then we'll need to export this package. I assume this will be a one-time update as a result?

Yes, that's the process I was envisioning. Curriculum writers can prep the changes in a branch in this repo, and they can even hardcode english strings while in development. Then, assuming we need this K-5 curriculum localized, we can move the strings into oceans.json, merge to main, publish a new version of this package, and then consume it on the studio side.

ebeastlake commented 4 months ago

Acknowledged/seems reasonable, pending approval by @bethanyaconnor. Thanks, @breville!

breville commented 4 months ago

LGTM -- just so we don't lose it, what's the "small change" you made to the K5 guides?

Oh, it's the test string here.