Cite ADR 0488 in the per-node bucket's doc comments (issue 1694)

go/declaration/filereference.go

@@ -16,7 +16,7 @@ const (
 	FileReferenceThreshold = 64 * 1024
 	// FileBucketPrefix starts the name of a node's object bucket, FileBucketFor(node), which holds the contents of the
 	// files of that node's declaration, each under the hex of its sha256 digest (ObjectName). One bucket per node,
-	// so a grant names it and a literal `*` is never needed (ADR 0486 §2). The controller alone writes it; the
+	// so a grant names it and a literal `*` is never needed (ADR 0486 §2, changed by ADR 0488 §1 and §2). The controller alone writes it; the
 	// node's engine reads an object by name.
 	FileBucketPrefix = "declaration-files-"
 	// FileStreamPrefix starts the name of the stream behind such a bucket, which the bus's grants name.
@@ -27,7 +27,8 @@ const (
 
 var nodeToken = regexp.MustCompile(`^[A-Za-z0-9_-]+$`)
 
-// FileBucketFor is the name of the object bucket of a node's files. The node name must be a name the bus accepts in a
+// FileBucketFor is the name of the object bucket of a node's files, "declaration-files-<node>" (novox/hq ADR 0488
+// §4, which replaces the single bucket constant of issue 1694). The node name must be a name the bus accepts in a
 // bucket and in a subject token: letters, digits, '_' and '-', so no '.', '*', '>' or space.
 func FileBucketFor(node string) (string, error) {
 	if !nodeToken.MatchString(node) {