{"id":28408425,"url":"https://github.com/tldr-pages/tldr-maintenance","last_synced_at":"2025-06-30T02:33:06.831Z","repository":{"id":204685883,"uuid":"712244302","full_name":"tldr-pages/tldr-maintenance","owner":"tldr-pages","description":":construction_worker: Calculates metrics about the current state of the tldr pages :wrench:","archived":false,"fork":false,"pushed_at":"2025-06-23T20:30:58.000Z","size":1183,"stargazers_count":15,"open_issues_count":39,"forks_count":5,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-06-23T21:34:50.967Z","etag":null,"topics":["hacktoberfest","insights","maintenance","tldr","tldr-pages"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tldr-pages.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"liberapay":"tldr-pages"}},"created_at":"2023-10-31T04:49:17.000Z","updated_at":"2025-06-23T20:31:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"2e727190-f9fa-4701-84db-7689a903d6be","html_url":"https://github.com/tldr-pages/tldr-maintenance","commit_stats":null,"previous_names":["tldr-pages/tldr-maintenance"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/tldr-pages/tldr-maintenance","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tldr-pages%2Ftldr-maintenance","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tldr-pages%2Ftldr-maintenance/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tldr-pages%2Ftldr-maintenance/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tldr-pages%2Ftldr-maintenance/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tldr-pages","download_url":"https://codeload.github.com/tldr-pages/tldr-maintenance/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tldr-pages%2Ftldr-maintenance/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262698968,"owners_count":23350213,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["hacktoberfest","insights","maintenance","tldr","tldr-pages"],"created_at":"2025-06-02T03:10:09.382Z","updated_at":"2025-06-30T02:33:06.814Z","avatar_url":"https://github.com/tldr-pages.png","language":"Python","funding_links":["https://liberapay.com/tldr-pages"],"categories":[],"sub_categories":[],"readme":"# tldr-maintenance\n\nThis repo runs a Bash script that calculates metrics about the current state of the [tldr-repo](https://github.com/tldr-pages/tldr).  \nThese [metrics](https://github.com/tldr-pages/tldr-maintenance/issues/25) will help contributors to quickly spot whether there is still work to do to maintain and improve the quality. It also helps to detect any issues in the [tldr-repo](https://github.com/tldr-pages/tldr).\n\n\u003e [!NOTE]\n\u003e Running [`set-alias-page.py`](https://github.com/tldr-pages/tldr/blob/main/scripts/set-alias-page.py) and [`wrong-filename.sh`](https://github.com/tldr-pages/tldr/blob/main/scripts/wrong-filename.sh) generates false-positives.\nThe results need to be checked by hand. It can be used by [CODEOWNERS](https://github.com/tldr-pages/tldr/blob/main/.github/CODEOWNERS) to watch their owned language to detect if there are changes needed.\n\n## Metrics\n\n### English\n\n- **Malformed more-info link page(s)**  \n  A page is malformed when the `\u003e More information: \u003clink\u003e.` does not match the format in the Python script.\n- **Missing TLDR page(s)**  \n  A page is missing when there is a page that references another page (like `tldr example`), but the other page doesn't exist.\n  Can also be seen implicit at [tldr translation](https://lukwebsforge.github.io/tldri18n/).\n- **Misplaced page(s)**  \n  A page is misplaced when the page isn’t inside a folder in the list of supported platforms.\n  Can also be seen implicit at [tldr translation](https://lukwebsforge.github.io/tldri18n/).\n- **Linter error(s)**  \n  Run the `markdownlint` and `tldr-lint` with specific checks enabled (only applies to the `tldr-lint`).\n\n### Other languages\n\n- **Malformed or outdated more-info link page(s)**  \n  A page is malformed when the `\u003e More information: \u003clink\u003e.` does not match the format in the Python script.  \n   A page is outdated when the `\u003e More information: \u003clink\u003e.` does not match the link in the English page.\n- **Missing TLDR page(s)**  \n  A page is missing when there is a page that references another page (like `tldr example`), but the other page doesn't exist.\n- **Misplaced page(s)**  \n  A page is misplaced when the page isn’t inside a folder in the list of supported platforms.\n  Can also be seen implicit at [tldr translation](https://lukwebsforge.github.io/tldri18n/).\n- **Outdated page(s) based on number of commands**  \n  A page is outdated when the number of commands differ from the number of commands in the English page.\n  Can also be seen at [tldr translation](https://lukwebsforge.github.io/tldri18n/).\n- **Outdated page(s) based on the commands itself**  \n  A page is outdated when the commands itself (every line that starts with \\`, but removing everything between `{{...}}`, `\"...\"` and `'...'`) differs from the English commands itself.\n- **Missing English page(s)**  \n  A page is missing when the filename can't be found as English page.\n  Can also be seen implicit at [tldr translation](https://lukwebsforge.github.io/tldri18n/).\n- **Missing translated page(s)**  \n  A page is missing when the English page can't be found as translated page.\n  Can also be seen implicit at [tldr translation](https://lukwebsforge.github.io/tldri18n/).\n- **Linter error(s)**  \n  Run the `markdownlint` and `tldr-lint` with specific checks enabled for the specific language (only applies to the `tldr-lint`).\n\n## Summary\n\nAt the end of the [`metrics-log.md`](https://github.com/tldr-pages/tldr-maintenance/releases/download/latest/metrics-log.md) a summary is written. \nThis summary is tracked in a [GitHub issue](https://github.com/tldr-pages/tldr-maintenance/issues/25), along with the metrics per translation. Some numbers include a percentage:\n\n- Total malformed or outdated more info link page(s) [with percentage, calculated based on total pages]\n- Total missing alias page(s)\n- Total missing TLDR commands [with percentage, calculated based on total of TLDR commands]\n- Total misplaced page(s) [with percentage, calculated based on total pages]\n- Total outdated page(s) based on number of commands [with percentage, calculated based on total non-English pages]\n- Total outdated page(s) based on the commands itself [with percentage, calculated based on total non-English pages]\n- Total missing English page(s) [with percentage, calculated based on total unique non-English pages]\n- Total missing translated page(s) [with percentage, calculated based on total of pages that need translation (total of English pages multiplied with number of languages)]\n- Total lint error(s)\n\n## Artifacts\n\nAfter a [workflow run](https://github.com/tldr-pages/tldr-maintenance/actions/workflows/calculate-metrics.yml) an artifact is created.  \nThis artifact can be downloaded and viewed to see the exact output per language per metric to see which page needs attention.\nA summary can also be downloaded at the [latest GitHub Release](https://github.com/tldr-pages/tldr-maintenance/releases/tag/latest).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftldr-pages%2Ftldr-maintenance","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftldr-pages%2Ftldr-maintenance","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftldr-pages%2Ftldr-maintenance/lists"}