dist/tools: add static check for missing board doc.md files

Author: Evgeniy Kuznetsov

dist/tools/board_doc_check/check.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+#
+# Copyright (C) 2026 Evgeniy Kuznetsov <evvykuznetsov@edu.hse.ru>
+#
+# This file is subject to the terms and conditions of the GNU Lesser
+# General Public License v2.1. See the file LICENSE in the top level
+# directory for more details.
+
+: "${RIOTBASE:=$(cd "$(dirname "$0")"/../../../ || exit; pwd)}"
+: "${RIOTTOOLS:=${RIOTBASE}/dist/tools}"
+
+# not running shellcheck with -x in the CI --> disable SC1091
+# shellcheck disable=SC1091
+. "${RIOTTOOLS}"/ci/github_annotate.sh
+
+github_annotate_setup
+
+EXIT_CODE=0
+
+for board_dir in "${RIOTBASE}"/boards/*/; do
+    board=$(basename "${board_dir}")
+
+    [ "${board}" = "common" ] && continue
+
+    if [ ! -f "${board_dir}/doc.md" ]; then
+        MSG="boards/${board}/doc.md is missing"
+        if github_annotate_is_on; then
+            github_annotate_error_no_file "${MSG}"
+        else
+            echo "ERROR: ${MSG}"
+        fi
+        EXIT_CODE=1
+    fi
+done
+
+github_annotate_teardown
+
+exit "${EXIT_CODE}"

dist/tools/ci/static_tests.sh

@@ -127,6 +127,7 @@ run ./dist/tools/headerguards/check.sh
 run ./dist/tools/buildsystem_sanity_check/check.sh
 run ./dist/tools/feature_resolution/check.sh
 run ./dist/tools/boards_supported/check.sh
+run ./dist/tools/board_doc_check/check.sh
 run ./dist/tools/codespell/check.sh
 run ./dist/tools/cargo-checks/check.sh
 run ./dist/tools/examples_check/check_has_readme.sh