docs: add troubleshooting note for cleaning up build artifacts
Change-Id: Idc055434a226416d160124be408d1962ce129d06
Signed-off-by: Jayanth Dodderi Chidanand <jayanthdodderi.chidanand@arm.com>
diff --git a/docs/getting_started/building.rst b/docs/getting_started/building.rst
index 8b7c704..0b0935b 100644
--- a/docs/getting_started/building.rst
+++ b/docs/getting_started/building.rst
@@ -74,6 +74,22 @@
So the `args.gn` file will be regenerated with the new values.
+Troubleshoot(Clean Up Artifacts)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Before building Hafnium, ensure the Clang toolchain is installed and available
+in your `PATH`. This is usually sufficient for a successful build.
+
+If you encounter errors related to missing or incompatible C library headers
+(e.g., after a failed build or toolchain update), clean up stale artifacts by running:
+
+.. code:: shell
+
+ make clobber
+
+This command removes previously generated build outputs, which can help resolve
+issues caused by outdated intermediate files. It's a useful troubleshooting step
+but not required for a fresh setup.
+
Using Docker
^^^^^^^^^^^^