cue/build: clean up the Instance docs a bit

Add a link, remove a redundant inline comment, and add an empty line so that a section separator is not joined with the godoc for the following field. Signed-off-by: Daniel Martí <[email protected]> Change-Id: I5810defec7507bffc281a948b1b6ff988eabf466 Dispatch-Trailer: {"type":"trybot","CL":1206581,"patchset":1,"ref":"refs/changes/81/1206581/1","targetBranch":"master"}
cue-lang · Jan 3, 2025 · 1e5daf1 · 1e5daf1
1 parent 7da6f24
commit 1e5daf1
Showing 1 changed file with 3 additions and 2 deletions.
diff --git a/cue/build/instance.go b/cue/build/instance.go
@@ -56,7 +56,7 @@ type Instance struct {
 
 	// ImportPath returns the unique path to identify an imported instance.
 	//
-	// Instances created with NewInstance do not have an import path.
+	// Instances created with [Context.NewInstance] do not have an import path.
 	ImportPath string
 
 	// Imports lists the instances of all direct imports of this instance.
@@ -84,7 +84,7 @@ type Instance struct {
 	// instance has no imports.
 	// If Module != "", this corresponds to the module root.
 	// Root/pkg is the directory that holds third-party packages.
-	Root string // root directory of hierarchy ("" if unknown)
+	Root string
 
 	// Dir is the package directory. A package may also include files from
 	// ancestor directories, up to the module file.
@@ -96,6 +96,7 @@ type Instance struct {
 	Incomplete bool `api:"alpha"`
 
 	// Dependencies
+
 	// ImportPaths gives the transitive dependencies of all imports.
 	ImportPaths []string               `api:"alpha"`
 	ImportPos   map[string][]token.Pos `api:"alpha"` // line information for Imports