8 Commits

Author SHA1 Message Date
Tu Tran
30badb256c Rebuild maintenance automation on GitHub Actions (README-as-data CI)
The old automation was entirely dead: .travis.yml ran awesome_bot on Travis
OSS (shut down), and .github/stale.yml targeted a defunct probot integration.
Result: dozens of dead links, years-old broken-link issues, and duplicate PRs
fixing the same link.

Adds scripts/check_readme.py, a stdlib-only Python validator that parses
README.md as structured data (grammar shared by every subcommand so lint/PR
checks/the weekly sweep can't drift apart):
- `lint`: whole-file grammar, duplicate-URL, and Table of Contents checks
- `check-diff`: flags only PR-added lines (shorteners, new http://, malformed
  entries) so pre-existing link rot can't fail unrelated PRs
- `check-links`: liveness-checks URLs with a 2-strike state machine, treating
  bot-hostile domains (Medium, Reddit, etc.) as BLOCKED rather than dead
- `report`: renders the weekly link-rot issue body

Wires this up via three workflows: validate-pr.yml (fork-safe PR gate),
link-rot.yml (weekly sweep, maintains one consolidated issue instead of
scattered reports), and stale-prs.yml (PRs only -- issues are explicitly
exempted, unlike the old probot config that buried broken-link reports).

Also replaces the generic issue/PR templates with ones that match what the
validator actually enforces, and fixes CONTRIBUTING.md's `*`-bullet examples
(the real source of format drift) to `-`.
2026-07-04 00:31:29 -07:00
Tu Tran
584915277c Remove outdated Google URL Shortener exception from guidelines (#897)
Google URL Shortener was discontinued in 2019. Applied manually from
PR #897, which conflicted with the just-merged #844.

Co-authored-by: chenlichao <chenlichao@users.noreply.github.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-03 22:59:02 -07:00
Mariam M. S
f1b8710ca9
Fix formatting and grammar in CONTRIBUTING.md (#844)
Corrected the following phrases:                                                                     1. "a new entry in table of contents"                                                               2. "Links must be pointing straight to the tutorials"                                                                                              3. "Pull request for each of the tutorial"
2026-07-03 22:56:00 -07:00
Mayank Srivastav
60b1f0697b
added point 18 in contribution guidline 2018-10-31 02:20:31 +05:30
Tu Tran
93b38ba506 Update CONTRIBUTING.md 2017-04-28 01:40:11 -04:00
Tu Tran
9551b48274 Update CONTRIBUTING.md 2017-04-28 01:38:35 -04:00
Tu Tran
f57c8365b4 fix some formatting errors 2017-04-28 01:34:19 -04:00
Tu Tran
db08438b06 add contribution guidelines 2017-04-28 01:32:31 -04:00