In the institution block we talk about the `lifetime`, which applies to the facilities. Do we want to move this somewhere else? Add it to the second scenario as a more advanced concept.

[abachma2]

Sub-issue of #427 that I felt needed more discussion.

in source/user/tutorial/add_reg_inst.rst we talk about the lifetime input with the institutions (see the Concept: Institutions section). We talk about the name, lifetime, config, and initialfacilitylist section. The last one is unique to institutions, but the others apply to the facility prototype definition sections (which are discussed before institutions) and regions. Therefore, it feels weird to me for us to wait so long to explicitly call out those tags.

Should we add a page just talking about the general format/structure of an input file? Any other ideas on how to reconcile this disconnect?

[gonuke]

Perhaps part of the issue is that we focus only on Facilities when we introduce the concept of prototypes (in source/user/tutorial/add_proto.rst). We cover name and config there, but imply that it only matters for facilities prototypes.

In one sense, we have covered it earlier (although not lifetime).

Suggested fix: discuss lifetime in add_proto.rst and make it clear that it applies to all prototypes - not just facilities

[abachma2]

That sounds like a good idea. That will also address the comment I had about source/user/tutorial/add_second_reactor.rst