| @@ -11,26 +11,26 @@ printf 'GITPOCKET_HOST=git.example.org\nGITPOCKET_UID=%s\nGITPOCKET_GID=%s\n' $( |
| 11 | 11 | docker compose -f deploy/compose.yaml up -d |
| 12 | 12 | ``` |
| 13 | 13 | |
| 14 | | -The web interface is then on `127.0.0.1:3200` and wants a reverse proxy with TLS in front of it. Sign up, then make yourself an administrator with `docker exec gitpocket gitpocket admin you`. [INSTALL.md](INSTALL.md) covers the Docker and binary installs, nginx, SSH, mail, backups and upgrades in order. |
| 14 | +The web interface is then on `127.0.0.1:3200` and wants a reverse proxy with TLS in front of it. Sign up and then make yourself an administrator with `docker exec gitpocket gitpocket admin you`. [INSTALL.md](INSTALL.md) covers the Docker and binary installs, nginx, SSH, mail, backups and upgrades in order. |
| 15 | 15 | |
| 16 | 16 | ## Features |
| 17 | 17 | |
| 18 | 18 | - Public, unlisted and private repositories under `~user/name`, with tree, log, blame, compare, history search and tar.gz or zip downloads of any ref |
| 19 | | -- Branches, a branch switcher on every file view and a notice when a branch with new commits was pushed, linking straight to a new pull request |
| 20 | | -- Pull requests from a branch or a fork with inline review, range diffs between force pushes, and merge, squash or rebase without a working tree |
| 19 | +- Branches, a branch switcher on every file view and a notice when a branch with new commits was pushed that links straight to a new pull request |
| 20 | +- Pull requests from a branch or a fork with inline review, range diffs between force pushes and merge, squash or rebase without a working tree |
| 21 | 21 | - Organisations, collaborators, issues, labels, stars, forks, branch protection and per owner disk quotas enforced during the push |
| 22 | 22 | - Profiles with a pinned repository list, an activity graph and a README from your `~you/you` repository |
| 23 | 23 | - SSH and PGP commit verification, TOTP, access tokens and Atom feeds for commits, issues and pull requests |
| 24 | 24 | - Site search over repositories and people with language facets |
| 25 | 25 | - Open, invite only or closed registration and an `/admin` page for accounts, invites, the front page and storage |
| 26 | 26 | |
| 27 | | -There is no wiki and no CI, and neither is planned. |
| 27 | +There is no wiki and no CI and neither is planned. |
| 28 | 28 | |
| 29 | 29 | ## Design |
| 30 | 30 | |
| 31 | | -Every read of git data calls the plumbing with a thirty second timeout, so a large repository costs exactly what git says it costs and nothing is parsed out of packfiles in process. Ref tables, trees, summaries and languages are cached against the mtime of the refs, which means one `stat` after a push invalidates them and deleting the cache loses nothing. |
| 31 | +Every read of git data calls the plumbing with a thirty second timeout so a large repository costs exactly what git says it costs and nothing is parsed out of packfiles in process. Ref tables, trees, summaries and languages are cached against the mtime of the refs, which means one `stat` after a push invalidates them and deleting the cache loses nothing. |
| 32 | 32 | |
| 33 | | -Pull requests fetch the source into `refs/pull/N/head` of the target, and merges are `merge-tree` and `commit-tree` followed by an `update-ref` that names the old value, so a push racing the merge button makes the merge fail instead of being overwritten. SQLite comes from the pure Go modernc port, which is why a `CGO_ENABLED=0` build needs nothing beside a system git. |
| 33 | +Pull requests fetch the source into `refs/pull/N/head` of the target. Merges are `merge-tree` and `commit-tree` followed by an `update-ref` that names the old value so a push racing the merge button makes the merge fail instead of being overwritten. SQLite comes from the pure Go modernc port which is why a `CGO_ENABLED=0` build needs nothing beside a system git. |
| 34 | 34 | |
| 35 | 35 | ## Usage |
| 36 | 36 | |
| @@ -47,8 +47,8 @@ SSH pushes need a key added under settings, and HTTPS pushes take an access toke |
| 47 | 47 | go test ./... |
| 48 | 48 | ``` |
| 49 | 49 | |
| 50 | | -The tests drive the real handler through `httptest`, covering each registration mode, cross site posts, private repositories, moved repositories, every merge strategy and Markdown injection payloads. |
| 50 | +The tests drive the real handler through `httptest` and cover each registration mode, cross site posts, private repositories, moved repositories, every merge strategy and Markdown injection payloads. |
| 51 | 51 | |
| 52 | 52 | ## Licence |
| 53 | 53 | |
| 54 | | -MIT. KaTeX is MIT as well and Source Sans 3 is under the OFL, with both notices kept beside the files. |
| 54 | +MIT. KaTeX is MIT as well and Source Sans 3 is under the OFL with both notices kept beside the files. |