Design Decisions

Naming of resources

Provisioned resources are named according to this guidance:

• Best practices - naming convention
• Recommended abbreviations for Azure resource types
• Naming rules and restrictions for Azure resources

We are using "oea" as the abbreviation for Open Edu Analytics throughout the naming because:

• It's small. It could be more explicit if made longer, but this would reduce the number of available characters available for other aspects of the name.
• It's lowercase because synapse workspace names are restricted to lowercase. Most other resources are not restricted to lowercase, but for consistency we're using lowercase for all resources.

Many organizations have their own established naming convention that they need to follow.
Those needing to specify a custom naming convention can make changes to set_names.sh, which is sourced by setup process, and the provisioned Azure resources will be named as specified.

Use of cloudshell and bash

Using cloudshell allows for a setup experience that is more consistent across customers and doesn't require a specific developer environment.

Using bash instead of PowerShell has been mostly about preference. This may be ported to PowerShell if the community has a strong preference for it.