ci(static-checks): improve error messages in include order check

Provide more insightful messages linter messages for include order
errors. Include a link to the online documentation and identify the
erroneous files, not the files that follow it (as is the case
currently).

Signed-off-by: Harrison Mutai <harrison.mutai@arm.com>
Change-Id: I5ee65ca218e8341643338ce17a14142a20cf66d0
diff --git a/script/static-checks/static-checks-include-order.sh b/script/static-checks/static-checks-include-order.sh
index 547e611..52e783c 100755
--- a/script/static-checks/static-checks-include-order.sh
+++ b/script/static-checks/static-checks-include-order.sh
@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 #
-# Copyright (c) 2019-2020 Arm Limited. All rights reserved.
+# Copyright (c) 2019-2022 Arm Limited. All rights reserved.
 #
 # SPDX-License-Identifier: BSD-3-Clause
 #
@@ -33,6 +33,8 @@
   echo "Result : FAILURE" >> "$LOG_TEST_FILENAME"
   echo >> "$LOG_TEST_FILENAME"
   cat "$LOG_FILE" >> "$LOG_TEST_FILENAME"
+  echo >> "$LOG_TEST_FILENAME"
+  echo -e "Please refer to the docs for further information on include statement ordering: https://trustedfirmware-a.readthedocs.io/en/latest/process/coding-style.html#include-statement-ordering." >> "$LOG_TEST_FILENAME"
 fi
 echo >> "$LOG_TEST_FILENAME"