Modify sync-in to also gather function descriptions

[bethanyaconnor]

First PR in the process of translating function descriptions.

Process I'm following:

1. (This PR) Update the sync-in script to gather the function descriptions. I'm changing the structure very slightly so that it's structured like:

level_url: {
  function_definitions: {
    function_name: {
      name: "function_name"
      description: "function description"
    }
  }
 }

Note that the key changed from function_names to function_definitions. I did this to make the transition a bit easier, plus it makes more sense.
2. Before running a sync that contains this PR, upload a file with the existing function names. This will allow duplication to work correctly.
3. Run a sync with this change. The out step will produce function_defintions.*.yml and will not update function_names.*.yml. Check in the function_defintions.*.yml files.
4. Modify localized_function_blocks to read from the new translation files. As part of that PR, delete function_names.*.yml.

This process limits the management of PR/sync timing to step 2. The sync out needs to happened before step 4, but there isn't any complicated PR juggling (i.e. making sure the updated rendering logic the sync go out in the same DTP).

Links

• spec
• jira

Testing story

Reviewer Checklist:

• Tests provide adequate coverage
• Code is well-commented
• New features are translatable or updates will not break translations
• Relevant documentation has been added or updated
• User impact is well-understood and desirable
• Pull Request is labeled appropriately
• Follow-up work items (including potential tech debt) are tracked and linked

[Hamms]

is it possible for there to be functions defined in two places that share the same name but have different descriptions?

[bethanyaconnor]

In the same level? That seems unlikely but I haven't checked

[Hamms]

oh, right! I forgot we broke these up by level

[Hamms]

Both code and process look good to me! I love having the process laid out here so explicitly, too!

[bethanyaconnor]

Uploaded a JSON with the function names to Crowdin -- all duplicates as expected. I'm going to merge this PR