WEB-3013 - automatic semantic color tag keys

content/en/dashboards/guide/semantic_colors.md

@@ -0,0 +1,9 @@
+---
+title: Semantic color guide
+kind: guide
+private: true
+---
+
+## Supported tag keys
+
+{{% semantic-color %}}

content/en/dashboards/guide/widget_colors.md

@@ -3,7 +3,7 @@ title: Selecting the right colors for your graphs
 kind: guide
 ---
 
-In Datadog graphs, color is the primary method by which you can distinguish between series of data. Selecting the right color for your graph ensures that your teammates can parse data in your graphs, draw insights, and troubleshoot effectively. 
+In Datadog graphs, color is the primary method by which you can distinguish between series of data. Selecting the right color for your graph ensures that your teammates can parse data in your graphs, draw insights, and troubleshoot effectively.
 
 {{< img src="dashboards/guide/colors/colors_top.png" alt="Under the heading 'Graph your data', the user is selecting from a list of color palettes." style="width:90%;" >}}
 
@@ -17,7 +17,7 @@ Categorical palettes are best used for data that needs to be differentiated, but
 
 #### Classic
 
-The default Classic palette uses a set of six distinct colors optimized for readability. Colors assigned to series repeat if the number of series exceeds six. Adjacent series have distinct colors. 
+The default Classic palette uses a set of six distinct colors optimized for readability. Colors assigned to series repeat if the number of series exceeds six. Adjacent series have distinct colors.
 
 The Classic color palette has visual accessibility support.
 
@@ -38,7 +38,7 @@ For a small subset of compatible tags, Datadog automatically recognizes the mean
 
 ### Diverging palettes
 
-Use a Diverging palette when you need to emphasize the difference in values within a data set. Diverging palettes are best suited to data that has a natural order and a natural midpoint. For example: the amount of change in memory utilization, from -100% to +100%, with a natural midpoint at 0%. 
+Use a Diverging palette when you need to emphasize the difference in values within a data set. Diverging palettes are best suited to data that has a natural order and a natural midpoint. For example: the amount of change in memory utilization, from -100% to +100%, with a natural midpoint at 0%.
 
 There are two Diverging palette options: cool (green and blue) or warm (interpolates between yellow and orange).
 

layouts/shortcodes/semantic-color.md

@@ -0,0 +1,2 @@
+| Tag key                       | Description                                                                                                                                                                                                                                                                                                    |
+| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

local/bin/py/build/actions/pull_and_push_file.py

@@ -23,6 +23,7 @@ def pull_and_push_file(content, content_dir):
     :param content: object with a file_name, a file_path, and options to apply
     :param content_dir: The directory where content should be put
     """
+    base_path = pathlib.Path(content["options"].get("base_path", content_dir))
     with open("".join(content["globs"]), mode="r+") as f:
         file_content = f.read()
         boundary = re.compile(r'^-{3,}$', re.MULTILINE)
@@ -49,14 +50,10 @@ def pull_and_push_file(content, content_dir):
 
     if output_content:
         destination_path = content["options"]["dest_path"].lstrip('/')
-        dest_path_dir = pathlib.Path(content_dir) / pathlib.Path(destination_path)
+        dest_path_dir = base_path / pathlib.Path(destination_path)
         dest_path_dir.mkdir(parents=True, exist_ok=True)
         with open(
-            "{}{}{}".format(
-                content_dir,
-                destination_path,
-                basename(content["options"]["file_name"]),
-            ),
+            dest_path_dir / pathlib.Path(basename(content["options"]["file_name"])),
             mode="w+",
             encoding="utf-8",
         ) as f:

local/bin/py/build/configurations/pull_config.yaml

@@ -1059,3 +1059,14 @@
             bundle_excludes:
               - "com.datadoghq.test"
               - "com.datadoghq.sample"
+
+      - repo_name: web-ui
+        contents:
+          - action: pull-and-push-file
+            branch: prod
+            globs:
+              - "generated/md/external/semantic-color-documentation.md"
+            options:
+              base_path: ""
+              dest_path: "/layouts/shortcodes/"
+              file_name: "semantic-color.md"

local/bin/py/build/configurations/pull_config_preview.yaml

@@ -1062,3 +1062,14 @@
             bundle_excludes:
               - "com.datadoghq.test"
               - "com.datadoghq.sample"
+
+      - repo_name: web-ui
+        contents:
+          - action: pull-and-push-file
+            branch: prod
+            globs:
+              - "generated/md/external/semantic-color-documentation.md"
+            options:
+              base_path: ""
+              dest_path: "/layouts/shortcodes/"
+              file_name: "semantic-color.md"