Add resource deployment samples for (#17734)

extensions/resource-deployment/DEVELOPER_GUIDE.md

@@ -174,7 +174,7 @@ See [NotebookWizardInfo](https://github.com/microsoft/azuredatastudio/blob/main/
 
 `required`
 
-`options`
+`options` - **REQUIRED** if `type` is `options`. See [Options](#options) for more information.
 
 `placeHolder`
 
@@ -196,6 +196,29 @@ See [NotebookWizardInfo](https://github.com/microsoft/azuredatastudio/blob/main/
 
 `valueProvider` - **OPTIONAL** If defined then the value for this field is retrieved using the specified [Value Provider](#value-provider).
 
+#### Options
+
+This defines the set of options for this field to display. There are a number of different ways to configure the set of options :
+
+* String array (`string[]`) - A static list of values that will be shown as a dropdown. Default value selected is defined as `FieldInfo.defaultValue`.
+
+* CategoryValue array (`azdata.CategoryValue[]`) - A static list of CategoryValue objects that will be shown as a dropdown. Each value will define a display name separate from its value - use this for values you want to display differently to the user (such as names for an Azure region).
+
+* [OptionsInfo](#optionsinfo) - An object allowing more control over the option values.
+
+See [sample-options](https://github.com/microsoft/azuredatastudio/blob/main/samples/sample-resource-deployment/package.json) for example implementations.
+
+##### OptionsInfo
+
+This object defines a set of options for a field, similar to the arrays that can be used for the [options](#options) field but with greater control over of the options. Currently there are two reasons that you would use this object over the arrays - either you want to display the options as something other than a dropdown or you wish to use an [Options Source Provider](#options-source-provider) to populate the options dynamically.
+
+`values` - An array of either `strings` or `azdata.CategoryValue` objects. See [options](#options) for more details on each of those.
+`defaultValue` - The string value of the default option to have selected
+`optionsType` - How to display the options, either `radio` or `dropdown`
+`source` - OPTIONAL If set defines the [Options Source Provider](#options-source-provider) to use for populating the options dynamically.
+
+### Options Source Provider
+
 ### Value Provider
 
 When a field specifies a value provider then it is saying that the value for that field is dynamic and will be retrieved from a value provider that is registered by an extension separately. This can be used for more complex logic such as running calculations, reading files, making web requests, etc.

extensions/resource-deployment/src/ui/modelViewUtils.ts

@@ -776,7 +776,10 @@ function processDropdownOptionsTypeField(context: FieldContext): azdata.DropDown
 	// Note we don't currently check that the value actually exists in the list - if it doesn't then it'll
 	// just default to the first one anyways
 	const initialValue = context.fieldInfo.variableName && context.initialVariableValues?.[context.fieldInfo.variableName]?.toString();
-	const defaultValue = initialValue || options.defaultValue;
+	const optionValues = options.values;
+	// If we have an array of CategoryValues then find the option that matches the defaultValue specified - otherwise just use the defaultValue provided
+	const defaultValueOption = (optionValues && optionValues.length > 0 && typeof optionValues[0] === 'object') ? (optionValues as azdata.CategoryValue[]).find(v => v.name === options.defaultValue) : options.defaultValue;
+	const defaultValue = initialValue || defaultValueOption;
 	const dropdown = createDropdownInputInfo(context.view, {
 		values: options.values,
 		defaultValue: defaultValue,