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
2 files changed