bp updates

martdob · Aug 27, 2019 · ccc644b · ccc644b
1 parent 8e441ad
commit ccc644b
Showing 1 changed file with 5 additions and 3 deletions.
diff --git a/1-CONTRIBUTION-GUIDE/best-practices.md b/1-CONTRIBUTION-GUIDE/best-practices.md
@@ -288,9 +288,11 @@ The following example shows how to use the reference function for the `storageUr
 
 Deployment artifacts are any files, in addition to the mainTemplate.json/azuredeploy.json and createUIDefinition.json files that are needed to complete a deployment.  For example, nested deployment templates or configuration scripts.  The following guidelines should be used when creating a solution with deployment artifacts:
 
-* **mainTemplate.json** and **createUIDefinition.json** must be in the root of the folder.  
-* Additional templates should be stored in the **nestedtemplates** folder.
-* Scripts should be stored in the **scripts** folder.
+* **mainTemplate.json** and **createUIDefinition.json** must be in the root of the folder. 
+* Additional artifacts should also be stored in subfolders.  
+  * Additional templates should be stored in the **nestedtemplates** folder.
+  * Scripts should be stored in the **scripts** folder.  
+* You do not have to use the folder names prescribed above, if a more appropriate or descriptive name is appropriate.  Just don't put everything in the root.
 
 NOTE: if your application uses the CustomScript extension for Windows – place configuration scripts and other artifacts in the **/** (root) folder rather than the **/scripts** subfolder.