Update docs and spec examples

Also update the template to fix a
validation error

doc/operations/metrics/dashboards/develop.md

@@ -15,12 +15,14 @@ commented-out examples you can use.
 Navigate to the browser-based editor of your choice:
 
 ### *Repository view*
+
   1. Navigate to **{doc-text}** **Repository > Files**.
   1. Click **{plus}** **Add to tree** and select **New file**,
              then click **Select a template type** to see a list of available templates:
              ![Metrics dashboard template selection](img/metrics_dashboard_template_selection_v13_3.png)
 
 ### *[Web IDE](../../../user/project/web_ide/index.md)* 
+
   1. Click **Web IDE** when viewing your repository.
   1. Click **{doc-new}** **New file**, then click **Choose a template** to see a list of available templates:
   ![Metrics dashboard template selection WebIDE](img/metrics_dashboard_template_selection_web_ide_v13_3.png)
@@ -29,4 +31,3 @@ Navigate to the browser-based editor of your choice:
 
 To enable and use a custom dashboard templates on your GitLab instance please follow
 [general guide](../../../user/admin_area/settings/instance_template_repository.md) on custom file templates
-

doc/user/admin_area/settings/instance_template_repository.md

@@ -58,7 +58,7 @@ extension and not be empty. So, the hierarchy should look like this:
 |-- LICENSE
     |-- custom_license.txt
     |-- another_license.txt
-|-- LICENSE
+|-- metrics-dashboards
     |-- custom_metrics-dashboard.yml
     |-- another_metrics-dashboard.yml
 ```

lib/gitlab/metrics/templates/Default.metrics-dashboard.yml

@@ -19,6 +19,6 @@ panel_groups:
         metrics:
             # Queries that make use of variables need to have double curly brackets {}
             # set to the variables, per the example below
-            query: 'max(go_memstats_alloc_bytes{job="{{job}}"}) / 1024 /1024'
+            - query: 'max(go_memstats_alloc_bytes{job="{{job}}"}) / 1024 /1024'
               unit: '%'
               label: "Max"

spec/lib/gitlab/template/gitlab_ci_yml_template_spec.rb

@@ -24,5 +24,5 @@ RSpec.describe Gitlab::Template::GitlabCiYmlTemplate do
     end
   end
 
-  include_examples 'template shared examples', 'Ruby', '.gitlab-ci.yml'
+  it_behaves_like 'file template shared examples', 'Ruby', '.gitlab-ci.yml'
 end

spec/lib/gitlab/template/metrics_dashboard_template_spec.rb

@@ -22,5 +22,5 @@ RSpec.describe Gitlab::Template::MetricsDashboardTemplate do
     end
   end
 
-  include_examples 'template shared examples', 'Default', '.metrics-dashboard.yml'
+  it_behaves_like 'file template shared examples', 'Default', '.metrics-dashboard.yml'
 end