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

[Sparsh1212]

Explanation

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

Script for ensuring that KDocs are present on all non-private:

• Classes
• Functions
• Values/fields
• Explicit constructors
• Companion objects
• Nested classes
• Enums
• Annotations
• Interfaces

Note: If any of the above member has an override modifier present, then it is automatically
exempted for the KDoc check.

Usage:
bazel run //scripts:kdoc_check -- <path_to_directory_root>

Arguments:

• path_to_directory_root: directory path to the root of the Oppia Android repository.

Example:
bazel run //scripts:kdoc_check -- $(pwd)

For testing the script, automated tests have been added.
To execute the tests, use:

bazel test //scripts/src/javatests/org/oppia/android/scripts/kdoc:KDocCheckTest

Note: We are generating the test assets dynamically at the time of executing them. The test assets are automatically deleted when the test finishes.

SS when the CI check fails:

Checklist

• The PR title starts with "Fix #bugnum: ", followed by a short, clear summary of the changes. (If this PR fixes part of an issue, prefix the title with "Fix part of #bugnum: ...".)
• The PR explanation includes the words "Fixes #bugnum: ..." (or "Fixes part of #bugnum" if the PR only partially fixes an issue).
• The PR follows the style guide.
• The PR does not contain any unnecessary auto-generated code from Android Studio.
• The PR is made from a branch that's not called "develop".
• The PR is made from a branch that is up-to-date with "develop".
• The PR's branch is based on "develop" and not on any other branch.
• The PR is assigned to an appropriate reviewer in both the Assignees and the Reviewers sections.

[BenHenning]

Thanks @Sparsh1212! I think this looks really great--the test name changes make them much clearer, I think.

I just noticed one comment didn't seem resolved, but I otherwise have nothing new to add.

Could you please fix the deltas on this PR & its title since #3352 was merged?

[Sparsh1212]

Thanks @Sparsh1212! I think this looks really great--the test name changes make them much clearer, I think.

I just noticed one comment didn't seem resolved, but I otherwise have nothing new to add.

Could you please fix the deltas on this PR & its title since #3352 was merged?

Thanks @BenHenning the PR is now updated and the one left a comment is also addressed. PTAL.
Also assigning to @anandwana001 for a pass.

[anandwana001]

Thanks @Sparsh1212
Took a quick pass on this. Left few suggestions. Also, please check on failing actions.

[Sparsh1212]

Thanks @Sparsh1212
Took a quick pass on this. Left few suggestions. Also, please check on failing actions.

Thanks, @anandwana001 followed up on all the suggestions. PTAL.

[BenHenning]

Thanks @Sparsh1212! LGTM.

[anandwana001]

LGTM