Apply suggestions from code review

Note: trying github's code review suggestions feature. Might cause CLA check to break.

Co-Authored-By: Cornelius Weig <22861411+corneliusweig@users.noreply.github.com>

pkg/index/indexscanner/scanner.go

@@ -42,7 +42,7 @@ func LoadPluginListFromFS(indexDir string) ([]index.Plugin, error) {
 		return nil, errors.Wrap(err, "failed to open index dir")
 	}
 
-	list := make([]index.Plugin, 0)
+	list := make([]index.Plugin, 0, len(files))
 	for _, f := range files {
 		if f.IsDir() {
 			continue
@@ -109,7 +109,7 @@ func DecodePluginFile(r io.Reader) (index.Plugin, error) {
 	}
 	decoder := json.NewDecoder(bytes.NewReader(jsonRaw))
 
-	// TODO(ahmetb): when we have a stable API that don't add new fields,
+	// TODO(ahmetb): when we have a stable API that won't add new fields,
 	// we can consider failing on unknown fields. Currently disabling due to
 	// incremental field additions to plugin manifests independently from the
 	// installed version of krew.

pkg/index/types.go

@@ -26,7 +26,7 @@ type Plugin struct {
 	Spec PluginSpec `json:"spec"`
 }
 
-// PluginSpec describes a plugin specification.
+// PluginSpec is the plugin specification.
 type PluginSpec struct {
 	Version          string `json:"version,omitempty"`
 	ShortDescription string `json:"shortDescription,omitempty"`
@@ -52,7 +52,7 @@ type Platform struct {
 	Bin string `json:"bin"`
 }
 
-// FileOperation explains a file copying operation from plugin archive to the
+// FileOperation specifies a file copying operation from plugin archive to the
 // installation directory.
 type FileOperation struct {
 	From string `json:"from,omitempty"`