docs: Remove redundant/stale docs

bump rocm-docs-core to 1.8.2

rm unused files

rm stale docs

fix sphinx conf

reorg docs

SWDEV-482203 -- add note to usage guides

update readmes

Change-Id: I9e0111ac8fe2a691ac964b27436ba47747c27904
Signed-off-by: Peter Park <Peter.Park@amd.com>

docs/reference/amdsmi-cpp-api.md

@@ -0,0 +1,21 @@
+---
+myst:
+  html_meta:
+    "description lang=en": "Explore the AMD SMI C++ API."
+    "keywords": "api, smi, lib, cpp, header, system, management, interface, ROCm"
+---
+
+# AMD SMI C++ API reference
+
+This section provides comprehensive documentation for the AMD SMI C++ API.
+Explore these sections to understand the full scope of available
+functionalities and how to implement them in your applications.
+
+- {doc}`Modules <../doxygen/docBin/html/modules>`
+
+- {doc}`Files <../doxygen/docBin/html/files>`
+
+- {doc}`Globals <../doxygen/docBin/html/globals>`
+
+- {doc}`Data structures <../doxygen/docBin/html/annotated>`
+

docs/reference/index.rst

@@ -1,14 +0,0 @@
-.. meta::
-  :description: Install AMD SMI
-  :keywords: install, SMI, AMD, ROCm
-
-******************
-API reference
-******************
-
-This section provides technical descriptions and important information about the different AMD SMI and library components.
-
-* {doc}`Library <../doxygen/docBin/html/files>`
-* {doc}`Functions <../doxygen/docBin/html/globals>`
-* {doc}`Data structures <../doxygen/docBin/html/annotated>`
-