detached 11411cf

docs(proto): list the note events of Watch

commit
11411cf5b9c2107e005d98d274d8bd850f607970
author
brice · · 2026-10-19 05:53 UTC
parent
0be2bc9
signature
GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email
checks
4/4
refs
tag: v0.8.0
2 files · +12 -9
M gen/ermite/ermiteconnect/event.connect.go +8 -6
@@ -47,7 +47,8 @@ type EventServiceClient interface {
4747 //
4848 // The events are repo_created, repo_updated, repo_deleted, pushed, gap and,
4949 // for merge requests, merge_request_opened, merge_request_merged,
50- // merge_request_closed and comment_added. Each one is delivered on the
50+ // merge_request_closed, comment_added, comment_edited, comment_deleted and
51+ // comment_resolved (a thread resolved or reopened). Each one is delivered on the
5152 // "repo:<name>" topic of its repository and on "home", subject to the
5253 // visibility of the repository.
5354 //
@@ -60,8 +61,8 @@ type EventServiceClient interface {
6061 // is not guaranteed, between jobs and runs or between two updates of the same
6162 // one: a client keeps the copy with the higher Run.version or
6263 // RunJob.version and drops the other. There is no event for a change of title or
63- // description, nor for a resolved comment: after a gap, or to see such
64- // changes, clients read the merge request again. A merge publishes
64+ // description: after a gap, or to see such changes, clients read the merge
65+ // request again. A merge publishes
6566 // merge_request_merged, then pushed for the target branch.
6667 //
6768 // The server keeps a bounded buffer of recent events. With resume_after set,
@@ -119,7 +120,8 @@ type EventServiceHandler interface {
119120 //
120121 // The events are repo_created, repo_updated, repo_deleted, pushed, gap and,
121122 // for merge requests, merge_request_opened, merge_request_merged,
122- // merge_request_closed and comment_added. Each one is delivered on the
123+ // merge_request_closed, comment_added, comment_edited, comment_deleted and
124+ // comment_resolved (a thread resolved or reopened). Each one is delivered on the
123125 // "repo:<name>" topic of its repository and on "home", subject to the
124126 // visibility of the repository.
125127 //
@@ -132,8 +134,8 @@ type EventServiceHandler interface {
132134 // is not guaranteed, between jobs and runs or between two updates of the same
133135 // one: a client keeps the copy with the higher Run.version or
134136 // RunJob.version and drops the other. There is no event for a change of title or
135- // description, nor for a resolved comment: after a gap, or to see such
136- // changes, clients read the merge request again. A merge publishes
137+ // description: after a gap, or to see such changes, clients read the merge
138+ // request again. A merge publishes
137139 // merge_request_merged, then pushed for the target branch.
138140 //
139141 // The server keeps a bounded buffer of recent events. With resume_after set,
@@ -47,7 +47,8 @@ type EventServiceClient interface {
47 //47 //
48 // The events are repo_created, repo_updated, repo_deleted, pushed, gap and,48 // The events are repo_created, repo_updated, repo_deleted, pushed, gap and,
49 // for merge requests, merge_request_opened, merge_request_merged,49 // for merge requests, merge_request_opened, merge_request_merged,
50- // merge_request_closed and comment_added. Each one is delivered on the50+ // merge_request_closed, comment_added, comment_edited, comment_deleted and
51+ // comment_resolved (a thread resolved or reopened). Each one is delivered on the
51 // "repo:<name>" topic of its repository and on "home", subject to the52 // "repo:<name>" topic of its repository and on "home", subject to the
52 // visibility of the repository.53 // visibility of the repository.
53 //54 //
@@ -60,8 +61,8 @@ type EventServiceClient interface {
60 // is not guaranteed, between jobs and runs or between two updates of the same61 // is not guaranteed, between jobs and runs or between two updates of the same
61 // one: a client keeps the copy with the higher Run.version or62 // one: a client keeps the copy with the higher Run.version or
62 // RunJob.version and drops the other. There is no event for a change of title or63 // RunJob.version and drops the other. There is no event for a change of title or
63- // description, nor for a resolved comment: after a gap, or to see such64+ // description: after a gap, or to see such changes, clients read the merge
64- // changes, clients read the merge request again. A merge publishes65+ // request again. A merge publishes
65 // merge_request_merged, then pushed for the target branch.66 // merge_request_merged, then pushed for the target branch.
66 //67 //
67 // The server keeps a bounded buffer of recent events. With resume_after set,68 // The server keeps a bounded buffer of recent events. With resume_after set,
@@ -119,7 +120,8 @@ type EventServiceHandler interface {
119 //120 //
120 // The events are repo_created, repo_updated, repo_deleted, pushed, gap and,121 // The events are repo_created, repo_updated, repo_deleted, pushed, gap and,
121 // for merge requests, merge_request_opened, merge_request_merged,122 // for merge requests, merge_request_opened, merge_request_merged,
122- // merge_request_closed and comment_added. Each one is delivered on the123+ // merge_request_closed, comment_added, comment_edited, comment_deleted and
124+ // comment_resolved (a thread resolved or reopened). Each one is delivered on the
123 // "repo:<name>" topic of its repository and on "home", subject to the125 // "repo:<name>" topic of its repository and on "home", subject to the
124 // visibility of the repository.126 // visibility of the repository.
125 //127 //
@@ -132,8 +134,8 @@ type EventServiceHandler interface {
132 // is not guaranteed, between jobs and runs or between two updates of the same134 // is not guaranteed, between jobs and runs or between two updates of the same
133 // one: a client keeps the copy with the higher Run.version or135 // one: a client keeps the copy with the higher Run.version or
134 // RunJob.version and drops the other. There is no event for a change of title or136 // RunJob.version and drops the other. There is no event for a change of title or
135- // description, nor for a resolved comment: after a gap, or to see such137+ // description: after a gap, or to see such changes, clients read the merge
136- // changes, clients read the merge request again. A merge publishes138+ // request again. A merge publishes
137 // merge_request_merged, then pushed for the target branch.139 // merge_request_merged, then pushed for the target branch.
138 //140 //
139 // The server keeps a bounded buffer of recent events. With resume_after set,141 // The server keeps a bounded buffer of recent events. With resume_after set,
M proto/ermite/event.proto +4 -3
@@ -17,7 +17,8 @@ service EventService {
1717 //
1818 // The events are repo_created, repo_updated, repo_deleted, pushed, gap and,
1919 // for merge requests, merge_request_opened, merge_request_merged,
20- // merge_request_closed and comment_added. Each one is delivered on the
20+ // merge_request_closed, comment_added, comment_edited, comment_deleted and
21+ // comment_resolved (a thread resolved or reopened). Each one is delivered on the
2122 // "repo:<name>" topic of its repository and on "home", subject to the
2223 // visibility of the repository.
2324 //
@@ -30,8 +31,8 @@ service EventService {
3031 // is not guaranteed, between jobs and runs or between two updates of the same
3132 // one: a client keeps the copy with the higher Run.version or
3233 // RunJob.version and drops the other. There is no event for a change of title or
33- // description, nor for a resolved comment: after a gap, or to see such
34- // changes, clients read the merge request again. A merge publishes
34+ // description: after a gap, or to see such changes, clients read the merge
35+ // request again. A merge publishes
3536 // merge_request_merged, then pushed for the target branch.
3637 //
3738 // The server keeps a bounded buffer of recent events. With resume_after set,
@@ -17,7 +17,8 @@ service EventService {
17 //17 //
18 // The events are repo_created, repo_updated, repo_deleted, pushed, gap and,18 // The events are repo_created, repo_updated, repo_deleted, pushed, gap and,
19 // for merge requests, merge_request_opened, merge_request_merged,19 // for merge requests, merge_request_opened, merge_request_merged,
20- // merge_request_closed and comment_added. Each one is delivered on the20+ // merge_request_closed, comment_added, comment_edited, comment_deleted and
21+ // comment_resolved (a thread resolved or reopened). Each one is delivered on the
21 // "repo:<name>" topic of its repository and on "home", subject to the22 // "repo:<name>" topic of its repository and on "home", subject to the
22 // visibility of the repository.23 // visibility of the repository.
23 //24 //
@@ -30,8 +31,8 @@ service EventService {
30 // is not guaranteed, between jobs and runs or between two updates of the same31 // is not guaranteed, between jobs and runs or between two updates of the same
31 // one: a client keeps the copy with the higher Run.version or32 // one: a client keeps the copy with the higher Run.version or
32 // RunJob.version and drops the other. There is no event for a change of title or33 // RunJob.version and drops the other. There is no event for a change of title or
33- // description, nor for a resolved comment: after a gap, or to see such34+ // description: after a gap, or to see such changes, clients read the merge
34- // changes, clients read the merge request again. A merge publishes35+ // request again. A merge publishes
35 // merge_request_merged, then pushed for the target branch.36 // merge_request_merged, then pushed for the target branch.
36 //37 //
37 // The server keeps a bounded buffer of recent events. With resume_after set,38 // The server keeps a bounded buffer of recent events. With resume_after set,

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 2

Tags 18

↑↓ moveenter openesc close