Skip to content

Commit 9800184

Browse files
Cleanup & improve docs (#4)
1 parent fa13a98 commit 9800184

File tree

4 files changed

+18
-95
lines changed

4 files changed

+18
-95
lines changed

.github/workflows/codecov.yml

Lines changed: 0 additions & 8 deletions
This file was deleted.

.github/workflows/nightly.yml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,3 +16,6 @@ jobs:
1616

1717
rust-version-check:
1818
uses: lurk-lab/ci-workflows/.github/workflows/rust-version-check.yml@main
19+
20+
typos:
21+
uses: lurk-lab/ci-workflows/.github/workflows/typos.yml@main

CONTRIBUTING.md

Lines changed: 0 additions & 79 deletions
This file was deleted.

README.md

Lines changed: 15 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,27 @@
11
# template-rust-lib
22
Base template for a Rust library crate with CI, config files, and branch protection
33

4-
## Notes
5-
- The generated repo will have a protected `main` branch with the following required status checks:
6-
- `linux-tests`
7-
- `code-quality/msrv`
8-
- `code-quality/lints`
9-
- `code-quality/wasm-build`
10-
- If the generated repo is public, it will enforce a merge queue using `squash and merge` by default
11-
- Run the following after generating the new repo:
4+
## Usage
5+
- Generate a new repo via the green "Use this template" button
6+
- Run the following to remove template language:
127
```
138
# Replace all occurrences with the desired library name
149
$ grep -ir template . --exclude-dir .git --exclude deny.toml
1510
# Replace all occurrences as needed
1611
$ grep -r "EDIT AS NEEDED" .
12+
# Then rewrite this `README`
1713
```
14+
- Create a branch protection rule for `main` and enable the following as needed:
15+
- Require a pull request before merging
16+
- Require 1 approval
17+
- Dismiss stale pull request approvals when new commits are pushed
18+
- Require approval of the most recent reviewable push
19+
- Require status checks to pass before merging (optional, after CI has been triggered)
20+
- E.g. `linux-test`, `msrv`, and `lints`
21+
- Require a merge queue using `squash and merge` (optional, only allowed if repo is public)
22+
- Allow force pushes if needed to bypass above restrictions when necessary
23+
- Enable full write access for Lurk Lab members by adding the `lurk-dev` team in `Settings->Collaborators and teams`
24+
- Edit licenses and `deny.toml` as needed
1825

1926
## License
2027

0 commit comments

Comments
 (0)