https://github.com/dknauss/.github
Default community health files for dknauss repositories
https://github.com/dknauss/.github
community-health defaults github
Last synced: 18 days ago
JSON representation
Default community health files for dknauss repositories
- Host: GitHub
- URL: https://github.com/dknauss/.github
- Owner: dknauss
- License: mit
- Created: 2026-03-21T23:19:31.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-22T00:52:29.000Z (3 months ago)
- Last Synced: 2026-03-22T15:06:23.347Z (3 months ago)
- Topics: community-health, defaults, github
- Language: Python
- Homepage: https://github.com/dknauss/.github
- Size: 9.77 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Support: SUPPORT.md
Awesome Lists containing this project
README
# dknauss/.github
Default community health files for repositories owned by `dknauss`.
Repositories with their own `CONTRIBUTING.md`, `SECURITY.md`, `SUPPORT.md`, issue templates, or pull request templates should prefer the repo-specific versions. Repositories without those files inherit the defaults from this repository.
## Tooling
This repo also holds small portfolio-maintenance tools:
- `tools/repo-bootstrap.sh`
Creates a new repo in `~/Developer/GitHub` using the default conventions:
`main` as the default branch, repo URL as the default homepage, and baseline topics by repo type.
- `tools/repo-health-audit.py`
Scans the local GitHub workspace, checks git cleanliness and integrity, runs `composer validate` where relevant, queries GitHub metadata, and emits a Markdown health report.
Examples:
```bash
# Dry-run a new WordPress plugin repo bootstrap.
bash tools/repo-bootstrap.sh \
--slug my-plugin \
--type wordpress-plugin \
--description "Short repo description" \
--dry-run
# Run a workspace health report.
python3 tools/repo-health-audit.py --workspace ~/Developer/GitHub
```
## Portfolio Defaults
Current standard for new repos:
- default branch: `main`
- homepage: repo URL by default
- exceptions:
- real project site when it is the primary landing page
- platform listing when it is the canonical install/discovery point
- release URL only when releases are the intended entry point
- baseline topics applied at creation time instead of retrofitted later