Some fine-tuning of krew.sigs.k8s.io

site/content/docs/developer-guide/plugin-manifest.md

@@ -146,14 +146,15 @@ files out of archive.
 The `files:` list specifies the copy operations (like `mv <from> <to>`) to
 the files `from` the archive `to` the installation destination.
 
-* **Example:** Extract all files (default behavior, you can omit `files:` altogether)
+* **Example:** Extract all files: If the `files:` list is unspecified, it defaults to:
 
-> If the `files:` list is unspecified, it defaults to:
-> ```yaml
-> files:
-> - from: *
->   to: .
-> ```
+  ```yaml
+  files:
+  - from: *
+    to: .
+  ```
+
+  > **Note:** If applicable, it is best practice to skip the `files:` list altogether.
 
 * **Example:** Copy specific files:
 
@@ -195,8 +196,9 @@ after installation is complete. The name of the symbolic link comes from the
 plugin name (i.e. the `metadata.name` field).
 
 > **Note on underscore conversion:** If your plugin name contains dashes, krew
-> will automatically convert them to underscores for kubectl to be able to find
-> your plugin.
+> will automatically convert them to underscores for
+> [kubectl](https://kubernetes.io/docs/tasks/extend-kubectl/kubectl-plugins/#names-with-dashes-and-underscores)
+> to be able to find your plugin.
 >
 > For example, if your plugin name is `view-logs` and your plugin binary is named
 > `run.sh`, krew will create a symbolic named `kubectl-view_logs` automatically.

site/content/docs/developer-guide/plugin-stats.md

@@ -23,7 +23,7 @@ This data is obtained by scraping the downloads count of your plugin assets on
 - does not distinguish between installs, reinstalls and upgrades
 - is purely a tracking of download counts of your release assets over time.
 
-> Note: Krew plugin stats dashboard is provided as a best effort by Krew
+> **Note:** Krew plugin stats dashboard is provided as a best effort by Krew
 > maintainers to measure success of Krew and its plugins. We cannot guarantee
 > its availability and accuracy.
 >

site/content/docs/user-guide/setup/uninstall.md

@@ -12,5 +12,5 @@ To remove Krew and plugins installed altogether, run this on your Linux/macOS ma
 
 On Windows, remove directory: `%USERPROFILE%\.krew`.
 
-> Note: If you installed Krew with another package manager (e.g. Homebrew),
+> **Note:** If you installed Krew with another package manager (e.g. Homebrew),
 > follow their installations in addition to instructions above.