Please read this file as a raw textual file, it has comments for people who create a new repo from this template.
This repository is a template that we use at Serokell to create new repositories. See GitHub documentation for more details about this feature.
If you have just created a new repo from this template, please start from here. Here are some things to keep in mind:
- We have a page in Notion describing how to create a new repository.
- Make sure to read meta-comments (you won't see them in rendered markdown because they are comments, but you can see them in raw files) and remove them eventually.
You can check that all meta-comments are removed using
git grep '\[\/\/\]:'. - Since we have repos at GitHub and GitLab, we provide both
.github/and.gitlab/folders, one of them should be removed. - Fill in
PROJECT.mdwith this repo's issue tracker, YouTrack project key, and team lead. Both contributors and coding agents read it. - We ship coding-agent instructions in
.claude/settings.json(plugin) and.github/copilot-instructions.md. Review the Copilot instructions and remove sections irrelevant to this repo. To customise a skill, add a local.claude/skills/<skill-name>/SKILL.mdthat overrides the plugin version. - The root LICENSE file is present because it's treated specially by GitHub and GitLab. Please put the right license there (or delete it if there is no license).
- Move any applicable licenses from
.reuse/LICENSES/toLICENSES/, and delete the rest. - In general, it's highly advised that you go over all files and check whether they make sense in your new repo. The aforementioned Notion page should help you. If you make a PR that adapts this template for your new project, reviewers of your PR can help you as well.
- Templates for nix infrastructure and CI are in a separate repository.
- Consider adding Danger-based PR/MR checks via the
serokell_dangergem. This is optional; see docs/danger.md. - Update
.xrefcheck.yaml: remove theignoreLocalRefsToentries for template placeholders (./img/logo.png,Makefile) and add any exclusions your repo actually needs. - Everything above this line, except for the copyright header, is supposed to be removed.
Patak is a modern tool which is good at doing X using Y because Z.
Build Instructions ↑
Run make to build everything.
Usage ↑
Launch patak executable and see how it does X.
If you pass --impress you will be impressed.
Pass --help to see all flags and options.
Issue Tracker ↑
We use YouTrack as our issue tracker. You can login using your GitHub account to leave a comment or create a new issue.
For Contributors ↑
Please see CONTRIBUTING.md for more information.
About Serokell ↑
Patak is maintained and funded with ❤️ by Serokell. The names and logo for Serokell are trademark of Serokell OÜ.
We love open source software! See our other projects or hire us to design, develop and grow your idea!
