https://github.com/wesley-dean/template
This is a general purpose template repository that configures a variety of scanners, workflows, semantic versioning, conventional commits, and basic community-supporting documentation.
https://github.com/wesley-dean/template
community documentation megalinter security-automation template-generic-repo
Last synced: 5 months ago
JSON representation
This is a general purpose template repository that configures a variety of scanners, workflows, semantic versioning, conventional commits, and basic community-supporting documentation.
- Host: GitHub
- URL: https://github.com/wesley-dean/template
- Owner: wesley-dean
- License: cc0-1.0
- Created: 2025-03-14T12:06:59.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-01-13T03:58:48.000Z (5 months ago)
- Last Synced: 2026-01-13T06:51:37.350Z (5 months ago)
- Topics: community, documentation, megalinter, security-automation, template-generic-repo
- Homepage:
- Size: 202 KB
- Stars: 4
- Watchers: 2
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
- Security: SECURITY.md
- Support: SUPPORT.md
Awesome Lists containing this project
README
# template
## Description
This is a template for a README.md file. It is a markdown file that is used to
describe a project. It is used to provide information about the project to the
users and contributors. It is a good practice to have a README.md file in your
project repository.
## Usage
You can use this template to create a README.md file for your project. You can
- Clone this repository
- Copy the README.md file to your project repository
- Edit the file to add information about your project
### Environment Variables
There are three environment variables that need to be set for this project to
work correctly:
- `PAT` - Your GitHub Personal Access Token
- `GPG_PRIVATE_KEY` - Your GPG Private Key
- `GPG_PRIVATE_KEY_PASSPHRASE` - Your GPG Private Key Passphrase
The `PAT` environment variable is used by MegaLinter to authenticate with the
GitHub API. The `GPG_PRIVATE_KEY` and `GPG_PRIVATE_KEY_PASSPHRASE` environment
variables are used to sign the commits that MegaLinter creates when
`APPLY_FIXES` is set to `true`.
If the MegaLinter action is disabled, none of these environment variables are
required.
### Conventional Commits
This project uses Conventional Commits. Conventional Commits is a specification
for adding human and machine readable meaning to commit messages. It is a
lightweight convention on top of commit messages. The specification can be
found at [conventionalcommits.org](https://www.conventionalcommits.org/).
Specifically, this project uses the
[bitshifted/git-auto-semver](https://github.com/bitshifted/git-auto-semver)
action to automatically increment the version number based on the commit
messages:
- `build`, `chore`, `ci`, `docs`, `fix`, `perf`, `refactor`, `revert`,
`style`, `test`: bump micro (patch) number
- `feat`: bump minor version number
- `BREAKING CHANGE`: bump major version number
## Documentation
### Architecture Decision Records (ADRs)
This project is configured to use [Nat Pryce's](https://github.com/npryce)
[adr-tools](https://github.com/npryce/adr-tools) project. There is a template
at `doc/adrs/templates/template.md` which can be edited at-will. The ADR
template is built to support both human and machine (AI/LLM)-produced and
maintained ADRs. The configuration file, `.adr-dir` resides at the root of
the project and may be updated if ADRs are to be stored in an alternate
directory.
For more information about ADRs, check out
[Michael Nygard](https://cognitect.com/authors/MichaelNygard.html)'s
[article](https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions)
on the topic.
## License
This project is licensed under the Creative Commons License 1.0 Universal
License - see the [LICENSE](LICENSE) file for details.
## Contributing
Contributions are welcome. Please read the [CONTRIBUTING.md](CONTRIBUTING.md)
file for details.
### Code of Conduct
Please read the [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) file for details on
the code of conduct. Long story short, be nice to each other and treat each
other with respect, compassion, and empathy, especially when you disagree.
## Authors
- Wes Dean