Fix #3304: Add check to ensure KDoc presence for non-private members

.github/workflows/static_checks.yml

@@ -123,3 +123,8 @@ jobs:
         if: always()
         run: |
           bazel run //scripts:accessibility_label_check -- $(pwd) scripts/assets/accessibility_label_exemptions.pb app/src/main/AndroidManifest.xml
+
+      - name: KDoc Validation Check
+        if: always()
+        run: |
+          bazel run //scripts:kdoc_validity_check -- $(pwd) scripts/assets/kdoc_validity_exemptions.pb

scripts/BUILD.bazel

@@ -6,6 +6,7 @@ load("@io_bazel_rules_kotlin//kotlin:kotlin.bzl", "kt_jvm_binary", "kt_jvm_libra
 load(
     "//scripts:script_assets.bzl",
     "generate_accessibility_label_assets_list_from_text_protos",
+    "generate_kdoc_validity_assets_list_from_text_protos",
     "generate_maven_assets_list_from_text_protos",
     "generate_regex_assets_list_from_text_protos",
     "generate_test_file_assets_list_from_text_protos",
@@ -131,3 +132,18 @@ kt_jvm_binary(
         "//scripts/src/java/org/oppia/android/scripts/label:accessibility_label_check_lib",
     ],
 )
+
+KDOC_VALIDITY_EXEMPTION_ASSETS = generate_kdoc_validity_assets_list_from_text_protos(
+    name = "kdoc_validity_exemption_assets",
+    kdoc_validity_exemptions_name = ["kdoc_validity_exemptions"],
+)
+
+kt_jvm_binary(
+    name = "kdoc_validity_check",
+    testonly = True,
+    data = KDOC_VALIDITY_EXEMPTION_ASSETS,
+    main_class = "org.oppia.android.scripts.docs.KdocValidityCheckKt",
+    runtime_deps = [
+        "//scripts/src/java/org/oppia/android/scripts/docs:kdoc_validity_check_lib",
+    ],
+)

scripts/script_assets.bzl

@@ -112,3 +112,27 @@ def generate_accessibility_label_assets_list_from_text_protos(
         proto_dep_bazel_target_prefix = "//scripts/src/java/org/oppia/android/scripts/proto",
         proto_package = "proto",
     )
+
+def generate_kdoc_validity_assets_list_from_text_protos(
+        name,
+        kdoc_validity_exemptions_name):
+    """
+    Converts a single list of text proto assets to binary.
+
+    Args:
+        name: str. The name of this generation instance. This will be a prefix for derived targets.
+        kdoc_validity_exemptions_name: list of str. The list of kdoc validity exemptions file name.
+
+    Returns:
+        list of str. The list of new proto binary asset files that were generated.
+    """
+    return generate_proto_binary_assets(
+        name = name,
+        names = kdoc_validity_exemptions_name,
+        proto_dep_name = "script_exemptions",
+        proto_type_name = "KdocValidityExemptions",
+        name_prefix = name,
+        asset_dir = "assets",
+        proto_dep_bazel_target_prefix = "//scripts/src/java/org/oppia/android/scripts/proto",
+        proto_package = "proto",
+    )

scripts/src/java/org/oppia/android/scripts/docs/BUILD.bazel

@@ -0,0 +1,17 @@
+"""
+Libraries corresponding to documentation-related scripts.
+"""
+
+load("@io_bazel_rules_kotlin//kotlin:kotlin.bzl", "kt_jvm_library")
+
+kt_jvm_library(
+    name = "kdoc_validity_check_lib",
+    testonly = True,
+    srcs = ["KdocValidityCheck.kt"],
+    visibility = ["//scripts:oppia_script_binary_visibility"],
+    deps = [
+        "//scripts/src/java/org/oppia/android/scripts/common:repository_file",
+        "//scripts/src/java/org/oppia/android/scripts/proto:script_exemptions_java_proto_lite",
+        "//third_party:org_jetbrains_kotlin_kotlin-compiler-embeddable",
+    ],
+)