fix(docs): Add synopsis for bind apiservice and preserve list formatting

Signed-off-by: olalekan odukoya <odukoyaonline@gmail.com>

Author: olamilekan000

cli/pkg/help/help.go

@@ -18,7 +18,6 @@ package help
 
 import (
 	"io"
-	"regexp"
 	"strings"
 	"unicode"
 
@@ -28,12 +27,45 @@ import (
 	"k8s.io/component-base/term"
 )
 
-var reEmptyLine = regexp.MustCompile(`(?m)([\w[:punct:]])[ ]*\n([\w[:punct:]])`)
-
 func Doc(s string) string {
 	s = heredoc.Doc(s)
-	s = reEmptyLine.ReplaceAllString(s, "$1 $2")
-	return s
+
+	lines := strings.Split(s, "\n")
+	result := make([]string, 0, len(lines))
+
+	for i, line := range lines {
+		trimmed := strings.TrimSpace(line)
+
+		if isListItem(line) {
+			result = append(result, line)
+			continue
+		}
+
+		if trimmed == "" && i < len(lines)-1 && isListItem(lines[i+1]) {
+			result = append(result, line)
+			continue
+		}
+
+		if len(result) > 0 && trimmed != "" {
+			prevLine := result[len(result)-1]
+			prevTrimmed := strings.TrimSpace(prevLine)
+
+			if prevTrimmed != "" && !isListItem(prevLine) {
+				if i > 0 && strings.TrimSpace(lines[i-1]) == "" {
+					if i < len(lines)-1 && isListItem(lines[i+1]) {
+						result = append(result, line)
+						continue
+					}
+					result[len(result)-1] = prevLine + " " + trimmed
+					continue
+				}
+			}
+		}
+
+		result = append(result, line)
+	}
+
+	return strings.Join(result, "\n")
 }
 
 func FitTerminal(out io.Writer) {
@@ -46,3 +78,10 @@ func FitTerminal(out io.Writer) {
 		return strings.TrimRightFunc(wordwrap.String(s, cols), unicode.IsSpace)
 	})
 }
+
+func isListItem(line string) bool {
+	trimmed := strings.TrimSpace(line)
+	return strings.HasPrefix(trimmed, "-") ||
+		strings.HasPrefix(trimmed, "*") ||
+		strings.HasPrefix(trimmed, "+")
+}

cli/pkg/kubectl/bind-apiservice/cmd/cmd.go

@@ -24,6 +24,7 @@ import (
 	"k8s.io/cli-runtime/pkg/genericclioptions"
 	logsv1 "k8s.io/component-base/logs/api/v1"
 
+	"github.com/kube-bind/kube-bind/cli/pkg/help"
 	"github.com/kube-bind/kube-bind/cli/pkg/kubectl/bind-apiservice/plugin"
 
 	_ "k8s.io/client-go/plugin/pkg/client/auth/exec"
@@ -43,8 +44,19 @@ var (
 func New(streams genericclioptions.IOStreams) (*cobra.Command, error) {
 	opts := plugin.NewBindAPIServiceOptions(streams)
 	cmd := &cobra.Command{
-		Use:          "apiservice https://<url-to-a-APIServiceExportRequest>|-f <file-to-a-APIBindingRequest>",
-		Short:        "Bind to a remote API service",
+		Use:   "apiservice https://<url-to-a-APIServiceExportRequest>|-f <file-to-a-APIBindingRequest>",
+		Short: "Bind to a remote API service",
+		Long: help.Doc(`Bind to a remote API service by creating an APIServiceExportRequest.
+
+This command allows you to bind remote services into your cluster by either:
+
+- Providing a URL to an APIServiceExportRequest resource
+- Providing a file containing an APIServiceExportRequest manifest
+- Using a template name to interactively create the binding
+
+The command will authenticate with the remote service provider, create the necessary
+APIServiceExportRequest, and deploy a konnector to establish the connection between
+your cluster and the remote service.`),
 		Example:      fmt.Sprintf(bindAPIServiceExampleUses, "kubectl bind"),
 		SilenceUsage: true,
 		RunE: func(cmd *cobra.Command, args []string) error {

cli/pkg/kubectl/dev/cmd/cmd.go

@@ -88,20 +88,20 @@ func newInitCommand(streams genericclioptions.IOStreams) (*cobra.Command, error)
 	cmd := &cobra.Command{
 		Use:   "create",
 		Short: "Create development environment with kind cluster and kube-bind backend",
-		Long: help.Doc(`
-		Create a complete development environment for kube-bind using kind clusters.
-		
-		This command will:
-		- Create a kind cluster configured for kube-bind development
-		- Add kube-bind.dev.local to /etc/hosts (with sudo prompts if needed)
-		- Install kube-bind backend helm chart (default: OCI chart from ghcr.io)
-		- Configure necessary port mappings (8443, 15021)
-		
-		The backend chart can be sourced from:
-		- OCI registry (default): oci://ghcr.io/kube-bind/charts/backend
-		- Local filesystem: --chart-path ./deploy/charts/backend
-		- Custom OCI registry: --chart-path oci://custom.registry/charts/backend
-	`),
+		Long: help.Doc(`Create a complete development environment for kube-bind using kind clusters.
+
+This command will:
+
+- Create a kind cluster configured for kube-bind developmentls
+- Add kube-bind.dev.local to /etc/hosts (with sudo prompts if needed)
+- Install kube-bind backend helm chart (default: OCI chart from ghcr.io)
+- Configure necessary port mappings (8443, 15021)
+
+The backend chart can be sourced from:xw
+
+- OCI registry (default): oci://ghcr.io/kube-bind/charts/backend
+- Local filesystem: --chart-path ./deploy/charts/backend
+- Custom OCI registry: --chart-path oci://custom.registry/charts/backend`),
 		Example:      fmt.Sprintf(DevCreateExampleUses, "kubectl bind dev"),
 		SilenceUsage: true,
 		Args:         cobra.NoArgs,