1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
# Things To Check
[](https://travis-ci.org/ojacobson/things-to-check)
A friend of mine used to run an IRC bot that could provide "helpful"
troubleshooting suggestions, based on places the folks in that chat had stubbed
their toes in the past.
I thought this was such a good idea, I turned it into a web bot.
## You Will Need
Want to work on this code, or run it yourself? Install the following:
* [An installed copy of the Rust toolchain](https://rustup.rs).
Building, testing, &c follow Rust norms: use
[Cargo](https://doc.rust-lang.org/cargo/guide/working-on-an-existing-project.html)
to build, test, or run the code locally.
## Configuration
By default, this app will listen on `http://localhost:3000/`. You can change the
port number by exporting a `PORT` environment variable in the process where this
program runs.
## Vocabulary
The list of suggestions is given by the `src/things-to-check.yml` file, which
contains a YAML list of strings. Each string is a Markdown snippet to render in
the page as a suggestion.
Stable links provide the user with an index into this list. When you insert new
items, insert them at the end.
## Git hooks
This project includes a pre-commit and a pre-merge-commit hook to run tests.
Using this hook is optional, but it'll catch a lot of minor breakage before
Travis does.
**Security note**: Enabling in-repository hooks means that anyone who can commit
code to this repository can run that code on your computer. Only do this if
you're willing to take that chance.
To set this up:
* Install additional Rust components and Cargo binaries:
```bash
tools/install-tool-dependencies
```
* Configure Git to use these hooks:
```bash
git config core.hooksPath .git-hooks
```
This only needs to be done once, and applies only to this project. To undo this,
unset `core.hooksPath`:
```bash
git config --unset core.hooksPath
```
You can also temporarily suppress the hook with `git commit --no-verify`, if you
have broken code you want to check in, or if the internet is unavailable for
Cargo to download dependencies.
|
