9 Commits

Author SHA1 Message Date
Paul Scheduikat
87ebebb520 format testscript files with gofmt 2025-06-15 17:25:20 +01:00
Daniel Martí
8e7765ee6f CONTRIBUTING: introduce -toolexec and add more dev tips
I've explained this before, such as over chat or talks with slides,
so it's time to have a proper version in our docs.

It doesn't really belong in the README, because a user shouldn't have to
understand these internal details.

The way Go builds with -toolexec spawn sub-processes is a bit tricky,
so I've attempted to demonstrate it with a vertical tree using Unicode.
Each added indentation level is one more sub-process level.
2022-03-24 11:34:18 +00:00
Daniel Martí
bd0705a536 amend redirecting URLs via "xurls -fix" 2021-12-24 14:07:24 -05:00
Daniel Martí
5d49955998 README: document commands
While at it, slightly tweak and update the rest of the markdown docs.
2021-04-06 08:34:59 -04:00
Daniel Martí
1336711c9c CONTRIBUTING: include some basic terminology (#188)
Fixes #132.
2020-11-08 17:16:12 +01:00
Daniel Martí
6b6a6eee2e CONTRIBUTING: clarify that tests are required (#138)
See https://github.com/burrowers/garble/issues/121#issuecomment-695935859.

In some rare cases, it's nearly impossible to write a test for a change,
but they are truly so rare that we shouldn't give any ideas here.

By default, all contributors should try to write a test for every
change that changes what the code is meant to do.
2020-09-21 13:01:49 +02:00
Daniel Martí
805c895d59 set up an AUTHORS file to attribute copyright
Many files were missing copyright, so also add a short script to add the
missing lines with the current year, and run it.

The AUTHORS file is also self-explanatory. Contributors can add
themselves there, or we can simply update it from time to time via
git-shortlog.

Since we have two scripts now, set up a directory for them.
2020-09-06 21:22:14 +01:00
Daniel Martí
cfd45d9a18 PRs with one review and CI are now mandatory (#92) 2020-08-12 14:20:36 +02:00
Daniel Martí
9c4b7d5a44 add the first benchmark and CONTRIBUTING doc 2020-07-16 16:02:51 +01:00