docs(completion): skip generated reference policies for completion (#852

)

This documentation will just pollute the completion with many items and
is less worthwhile on the command line.

-----

UDENG-1039

cmd/adsysd/integration_tests/adsysctl_doc_test.go

@@ -118,8 +118,11 @@ func TestDocCompletion(t *testing.T) {
 			var wantNumDocs int
 			docsDir := filepath.Join(rootProjectDir, "docs")
 			err = filepath.WalkDir(docsDir, func(path string, d fs.DirEntry, err error) error {
-				// Ignore directories, every reference doc under reuse and compiled content.
-				if d.IsDir() || strings.HasPrefix(path, filepath.Join(docsDir, "reuse")) || strings.HasPrefix(path, docsDir+"/.") {
+				// Ignore directories, every reference doc under reuse, compiled content and any autogenerated policy documentation.
+				if d.IsDir() ||
+					strings.HasPrefix(path, filepath.Join(docsDir, "reuse")) ||
+					strings.HasPrefix(path, docsDir+"/.") ||
+					strings.HasPrefix(path, filepath.Join(docsDir, "reference", "policies")) {
 					return nil
 				}
 				if !strings.HasSuffix(d.Name(), ".md") {

internal/adsysservice/doc.go

@@ -131,6 +131,11 @@ func docStructure(dir embed.FS, indexFilePath, parentChapterName string) (ordere
 		}
 		p = filepath.Join(root, p) + ".md"
 
+		// Automated generated policies, ignore them.
+		if p == "reference/policies/index.md" {
+			continue
+		}
+
 		title, err := titleFromPage(dir, p)
 		if err != nil {
 			return nil, nil, nil, err