Unified configuration for metrics (#726)

* Show description of metrics during analysis
    * Use --include-cols Description show the Description column in analyze mode (this is hidden by default)
    * Remove tips field from analysis config

* Align metric names in analysis config and documentation

* Add unified config utils/unified_config.yaml

* Add python script utils/split_config.py to auto generate analysis configuration and documentation metrics description
   * Add test case to ensure unified config is older than auto-generated config
   * Auto generate analysis config and documentation metrics description

* Update CONTRIBUTING.md to add instructions to build documentation assets
    * Add docker image and compose file to build documentation

* Update CHANGELOG and Documentation

* Use jinja template instead of hardcoding metric tables in documentation

tests/test_autogen_config.py

@@ -0,0 +1,43 @@
+import hashlib
+from pathlib import Path
+
+import pytest
+import yaml
+
+
+@pytest.mark.autogen_config
+def test_modification_time():
+    # Ensure modification time of utils/unified_config.yaml is older than
+    # utils/autogen_hash.yaml
+    # docs/data/metrics_description.yaml and
+    # src/rocprof_compute_soc/analysis_configs/gfx*/*.yaml
+
+    unified_config_path = Path("utils/unified_config.yaml")
+    hash_path = Path("utils/autogen_hash.yaml")
+    docs_config_path = Path("docs/data/metrics_description.yaml")
+    analysis_config_paths = list(
+        Path("src/rocprof_compute_soc/analysis_configs").glob("gfx*/*.yaml")
+    )
+
+    assert (
+        unified_config_path.stat().st_mtime < hash_path.stat().st_mtime
+    ), f"{unified_config_path} is not older than {hash_path}"
+
+    assert (
+        unified_config_path.stat().st_mtime < docs_config_path.stat().st_mtime
+    ), f"{unified_config_path} is not older than {docs_config_path}"
+
+    for analysis_config_path in analysis_config_paths:
+        assert (
+            unified_config_path.stat().st_mtime < analysis_config_path.stat().st_mtime
+        ), f"{unified_config_path} is not older than {analysis_config_path}"
+
+    # Ensure hash map consistency
+
+    with open(hash_path, "r") as f:
+        hash_map = yaml.safe_load(f)
+    for file, hash in hash_map.items():
+        file_hash = hashlib.sha256(Path(file).read_bytes()).hexdigest()
+        assert (
+            file_hash == hash
+        ), f"Hash mismatch for {file}: expected {hash}, got {file_hash}"