diff --git a/projects/amdsmi/CHANGELOG.md b/projects/amdsmi/CHANGELOG.md
index 2e48898768..ef73c3b81e 100644
--- a/projects/amdsmi/CHANGELOG.md
+++ b/projects/amdsmi/CHANGELOG.md
@@ -16,7 +16,7 @@ Full documentation for amd_smi_lib is available at [https://rocm.docs.amd.com/pr
   values through the `-G/--gpuboard` or `-b/--baseboard` options or obtain all of them as normal using the `amd-smi metric` command without
   any options. If the hardware does not support gpuboard or baseboard temperatures, then the values will be hidden from the default `metric` view.
 
-```conosle
+```console
 $ amd-smi metric -b
 GPU: 0
     BASEBOARD:
diff --git a/projects/amdsmi/docs/conceptual/ras.md b/projects/amdsmi/docs/conceptual/ras.md
index 255fd0e04b..bfde30683b 100644
--- a/projects/amdsmi/docs/conceptual/ras.md
+++ b/projects/amdsmi/docs/conceptual/ras.md
@@ -70,18 +70,18 @@ information](/doxygen/docBin/html/group__tagRasInfo) for available APIs.
 ::::{tab-item} Python
 See related APIs:
 
-- [](#amdsmi_get_gpu_ecc_count)
-- [](#amdsmi_get_gpu_ecc_enabled)
-- [](#amdsmi_get_gpu_ecc_status)
-- [](#amdsmi_get_gpu_total_ecc_count)
-- [](#amdsmi_get_gpu_cper_entries)
-- [](#amdsmi_get_afids_from_cper)
-- [](#amdsmi_get_gpu_ras_feature_info)
-- [](#amdsmi_get_gpu_ras_block_features_enabled)
+- [](/reference/amdsmi-py-api.md#amdsmi_get_gpu_ecc_count)
+- [](/reference/amdsmi-py-api.md#amdsmi_get_gpu_ecc_enabled)
+- [](/reference/amdsmi-py-api.md#amdsmi_get_gpu_ecc_status)
+- [](/reference/amdsmi-py-api.md#amdsmi_get_gpu_total_ecc_count)
+- [](/reference/amdsmi-py-api.md#amdsmi_get_gpu_cper_entries)
+- [](/reference/amdsmi-py-api.md#amdsmi_get_afids_from_cper)
+- [](/reference/amdsmi-py-api.md#amdsmi_get_gpu_ras_feature_info)
+- [](/reference/amdsmi-py-api.md#amdsmi_get_gpu_ras_block_features_enabled)
 ::::
 
 ::::{tab-item} amd-smi CLI
-See [`amd-smi ras --help`](#cmd-ras) for details and available options.
+See [`amd-smi ras --help`](/how-to/amdsmi-cli-tool.md#amd-smi-ras) for details and available options.
 ```shell
 amd-smi ras --help
 ```
diff --git a/projects/amdsmi/docs/how-to/amdsmi-cli-tool.md b/projects/amdsmi/docs/how-to/amdsmi-cli-tool.md
index 9ce91b5f11..3cd206f9c1 100644
--- a/projects/amdsmi/docs/how-to/amdsmi-cli-tool.md
+++ b/projects/amdsmi/docs/how-to/amdsmi-cli-tool.md
@@ -811,8 +811,6 @@ Command Modifiers:
   --loglevel LEVEL         Set the logging level from the possible choices:
 ```
 
-(cmd-ras)=
-
 ### amd-smi ras
 
 Displays RAS information of specified devices.
@@ -1177,4 +1175,8 @@ This example code shows how to dump AFID errors in a CPER file
 ~$  sudo amd-smi ras --afid --cper-file /tmp/cper_dump/fatal-1.cper
 ```
 
-Refer to amd_smi_cper_example.py & amd_smi_afid_example.py for API examples
+Refer to
+[amd_smi_cper_example.py](https://github.com/ROCm/amdsmi/blob/amd-mainline/example/amd_smi_cper_example.py)
+and
+[amd_smi_afid_example.py](https://github.com/ROCm/amdsmi/blob/amd-mainline/example/amd_smi_afid_example.py)
+for API examples.
diff --git a/projects/amdsmi/docs/how-to/amdsmi-cpp-lib.md b/projects/amdsmi/docs/how-to/amdsmi-cpp-lib.md
index 065db85681..766bb90090 100644
--- a/projects/amdsmi/docs/how-to/amdsmi-cpp-lib.md
+++ b/projects/amdsmi/docs/how-to/amdsmi-cpp-lib.md
@@ -68,7 +68,7 @@ driver and make sure that any resources held by AMD SMI are released.
 1. A simple "Hello World" type program that displays the temperature of detected
    devices.
 
-   ```note
+   ```{note}
    Sample build example:
    $ g++ -I/opt/rocm/include <file_name>.cc -L/opt/rocm/lib -lamd_smi -o <filename>
 
@@ -158,7 +158,7 @@ driver and make sure that any resources held by AMD SMI are released.
 
 2. A sample program that displays the power of detected CPUs.
 
-   ```note
+   ```{note}
    Sample build example:
    $ g++ -DENABLE_ESMI -I/opt/rocm/include <file_name>.cc -L/opt/rocm/lib -lamd_smi -o <filename>
 
diff --git a/projects/amdsmi/docs/reference/amdsmi-py-api.md b/projects/amdsmi/docs/reference/amdsmi-py-api.md
index 17ee4fb1a3..cbfe9ebe27 100644
--- a/projects/amdsmi/docs/reference/amdsmi-py-api.md
+++ b/projects/amdsmi/docs/reference/amdsmi-py-api.md
@@ -1306,7 +1306,7 @@ Example:
         print(e)
 ```
 
-Refer to amd_smi_cper_example.py for a complete example
+Refer to [amd_smi_cper_example.py](https://github.com/ROCm/amdsmi/blob/amd-mainline/example/amd_smi_cper_example.py) for a complete example.
 
 ### amdsmi_get_afids_from_cper
 
@@ -1343,7 +1343,7 @@ Example:
         print(e)
 ```
 
-Refer to amd_smi_afid_example.py for a complete example
+Refer to [amd_smi_afid_example.py](https://github.com/ROCm/amdsmi/blob/amd-mainline/example/amd_smi_afid_example.py) for a complete example.
 
 
 ### amdsmi_get_gpu_ras_feature_info