max / makenotwork

docs: notes search and the notes feed Two paragraphs on the Notes tab's search and the per-repository RSS feed, plus the line that a blame row links straight to its note, which was already true and undocumented. Says plainly that search reads an index and that the repository stays the source of truth, because a reader who cannot see that would reasonably assume search is the thing that would be lost on export.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: Max Johnson <me@maxj.phd> · 2026-08-09 01:26 UTC

Signed with PGP, not checked

Commit: 1d4b864e1530b2d8e28cb99c2d1af6ebc90bd008

Parent: a89063b

1 file changed, +18 insertions, -2 deletions

M server/site-docs/public/guide/git-notes.md +18 -2

			@@ -10,8 +10,24 @@
10	10
11	11		- On the commit page, one panel per namespace, rendered as markdown.
12	12		- As a badge on commit log rows, so you can see which commits are annotated.
13		-	- On the Notes tab at `/git/username/repo-name/notes`, which lists every namespace with its count and a reverse-chronological feed of annotations.
14		-	- On the file and blame views, alongside the commit being shown.
	13	+	- On the Notes tab at `/git/username/repo-name/notes`, which lists every namespace with its count and a feed of annotations, newest first.
	14	+	- On the file and blame views, alongside the commit being shown. An annotated line in blame links straight to its note.
	15	+
	16	+	## Searching Notes
	17	+
	18	+	The Notes tab has a search box. It searches note text within the selected namespace, and understands quoted phrases and a leading `-` to exclude a word. There is a filter for notes on commits, which hides notes written on files and other objects.
	19	+
	20	+	Search reads an index MNW builds from your repository. The repository is the source of truth: the index can be dropped and rebuilt from the refs at any time, and nothing about a note is stored only there.
	21	+
	22	+	## Following Notes As a Feed
	23	+
	24	+	Every repository has an RSS feed of its annotations at:
	25	+
	26	+	```
	27	+	/git/username/repo-name/notes.rss
	28	+	```
	29	+
	30	+	Add `?namespace=review` for one namespace. Items are ordered by when each annotation was written, so annotating an old commit is news. Private repositories have no feed.
15	31
16	32		## Fetching Notes Into Your Clone
17	33