Does the Adding Regions and Institutions page need restructuring?

[connor-welch]

Currently, the Adding Regions and Institutions page is structured differently than the other pages of the tutorial. The way the page presents the concepts of regions and institutions somewhat treats regions and institutions as two separate blocks, when in reality, institutions are a part of the Region block. For example, we provide partial templates for the region block and the institution blocks within the region block, and then show a combined region and institution block template. Do we want to keep the partial templates to help explain the concepts of regions and institutions, or get rid of them and use the full template to explain the concepts?

Additionally, the page has activities that:

1. Write the Region Block
2. Save the input file as tutorial_oncethrough.xml
3. Add an extra institution into the Region Block
4. Save the input file as tutorial_oncethrough.xml again

Is there value in having a separate activity to add an extra institution, or could that be done when the Region block is first written?

[gonuke]

This is a fair point, but part of the reason for treating them separately is that they are different archetypes that serve different roles. It's important for users to understand that difference, even if the usage is tightly connected.

There is another thing that I've realized recently related to this: it's pretty clear how we go from archetype -> prototype -> many instances/agents for facilities. In practice it seems like we'll never have more than one instance of any region prototype or institution prototype. They are basically always one-off configurations of an archetype.