{"id":16105062,"url":"https://github.com/takanuva15/check-kdoc-present","last_synced_at":"2026-04-26T23:31:31.088Z","repository":{"id":195428564,"uuid":"361288950","full_name":"takanuva15/check-kdoc-present","owner":"takanuva15","description":"[WIP] A GitHub Action to verify that Kotlin classes in your repository have documentation on them","archived":false,"fork":false,"pushed_at":"2021-05-09T15:16:38.000Z","size":5427,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-06T02:33:43.465Z","etag":null,"topics":["check","documentation","github-actions","kdoc","kotlin","verify"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/takanuva15.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2021-04-24T23:37:36.000Z","updated_at":"2021-05-09T15:16:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"9c101f8e-4d66-4a36-baf4-29e28c240024","html_url":"https://github.com/takanuva15/check-kdoc-present","commit_stats":null,"previous_names":["takanuva15/check-kdoc-present"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/takanuva15/check-kdoc-present","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takanuva15%2Fcheck-kdoc-present","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takanuva15%2Fcheck-kdoc-present/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takanuva15%2Fcheck-kdoc-present/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takanuva15%2Fcheck-kdoc-present/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/takanuva15","download_url":"https://codeload.github.com/takanuva15/check-kdoc-present/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takanuva15%2Fcheck-kdoc-present/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32317163,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"ssl_error","status_checked_at":"2026-04-26T23:26:25.802Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["check","documentation","github-actions","kdoc","kotlin","verify"],"created_at":"2024-10-09T19:08:17.185Z","updated_at":"2026-04-26T23:31:31.069Z","avatar_url":"https://github.com/takanuva15.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"**This action is under construction. I do not know a complete working kotlin parser that's publicly available, so this action will throw random errors for valid Kotlin files with documentation. Use at your own risk.**\n\n# check-kdoc-present GitHub Action\nA simple GitHub Action that runs a sanity check on your code to verify that every Kotlin file has at least one Kotlin documentation comment (kdoc) present. This helps keep your code documented and helps other developers looking at your code know what's going on.\n\n## Getting Started\nAssuming all your Kotlin source files are in the `~/src/main/kotlin` directory within the root of your repository, add the following to a new file `.github/workflows/verify_pr.yml`:\n\n```yaml\nname: Run PR Checks\non:\n  pull_request:\n    branches:\n    - main\n\njobs:\n  check_kdoc:\n    name: Verify KDoc Present on all Kotlin Classes\n    runs-on: ubuntu-latest\n    steps:\n    - uses: actions/checkout@v2\n    - name: Verify KDoc Present on all Kotlin Classes\n      uses: takanuva15/check-kdoc-present@main\n```\nCommit the file and create a PR to `main` - you should see the action run.\n\n## Additional Usage Parameters\n- `kotlin_dir`: The directory within your repository root that contains the Kotlin files you want to check\n    - Default is `src/main/kotlin`\n\nSample usage:\n```yaml\nsteps:\n  - uses: actions/checkout@v2 #must checkout the repo for the action to have access to the Kotlin files\n  - name: Verify KDoc Present on all Kotlin Classes\n    uses: takanuva15/check-kdoc-present@main\n    with:\n      kotlin_dir: src/main/java\n```\n\n## Contributing\nWe are happy to take contributions. If you experience an issue or see something that can be improved, feel free to raise an issue. Assuming that there is agreement on the issue, fork the repo and raise a PR to make your change.\n\nIf you like this action, feel free to star/watch the repo to show your support!\n\n## Credits\n- Credit to [kotlinx/ast](https://github.com/kotlinx/ast) for providing the implementation of the kotlin parser.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftakanuva15%2Fcheck-kdoc-present","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftakanuva15%2Fcheck-kdoc-present","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftakanuva15%2Fcheck-kdoc-present/lists"}