Generating Command Completion and Documentation

Two features that improve our user experience are command completion and documentation. Command completion guides the user by providing contextual suggestions when they press the “Tab” key. Documentation instructs users by providing additional information, context, and examples about using the application.

Adding subcommands

Let’s add two new subcommands to our tool, allowing the users to generate command completion and documentation for it. We start with the command completion subcommand completion. We use the Cobra generator again to add this subcommand to our application:

Then we edit the generated file cmd/completion.go. We update the import section by removing the fmt package as this command doesn’t use it. Also, we add the io package to use the io.Writer interface and the os package to use the file os.Stdout to print the command completion to STDOUT.

Next, we update the completionCmd definition by updating the Short description, including an example of how to use this feature in the Long description and replacing the property Run with ...