Add documentation for the credentials command

docs/commands/credentials.adoc

@@ -1,4 +1,43 @@
-=== `credentials create`
+=== `credentials`
+
+The `credentials` commands are used to perform credential management operations against Capella clusters.
+
+==== `credentials`
+
+Lists all the credentials on the active cluster:
+
+[options="nowrap"]
+```
+👤 Charlie 🏠 remote
+> credentials
+╭───┬──────────────────────────────────────┬────────────────┬─────────┬───────────────────────────────────────────────────────────────────────╮
+│ # │                  id                  │      name      │ cluster │                                access                                 │
+├───┼──────────────────────────────────────┼────────────────┼─────────┼───────────────────────────────────────────────────────────────────────┤
+│ 0 │ 354dd662-4d6a-4e1c-80f3-6c78eafa405a │ Administrator  │ remote  │ ╭───┬───────────────┬─────────────────────────┬─────────────────────╮ │
+│   │                                      │                │         │ │ # │    bucket     │         scopes          │     privileges      │ │
+│   │                                      │                │         │ ├───┼───────────────┼─────────────────────────┼─────────────────────┤ │
+│   │                                      │                │         │ │ 0 │ testing       │ ╭───┬───╮               │ ╭───┬─────────────╮ │ │
+│   │                                      │                │         │ │   │               │ │ 0 │ * │               │ │ 0 │ data_reader │ │ │
+│   │                                      │                │         │ │   │               │ ╰───┴───╯               │ ╰───┴─────────────╯ │ │
+│   │                                      │                │         │ │ 1 │ travel-sample │ ╭───┬─────────────────╮ │ ╭───┬─────────────╮ │ │
+│   │                                      │                │         │ │   │               │ │ 0 │ inventory       │ │ │ 0 │ data_reader │ │ │
+│   │                                      │                │         │ │   │               │ │ 1 │ tenant_agent_00 │ │ │ 1 │ data_writer │ │ │
+│   │                                      │                │         │ │   │               │ ╰───┴─────────────────╯ │ ╰───┴─────────────╯ │ │
+│   │                                      │                │         │ ╰───┴───────────────┴─────────────────────────┴─────────────────────╯ │
+│ 1 │ f0668638-0cf1-417c-8521-abbd1cbf0624 │ Administrator2 │ remote  │ ╭───┬────────┬───────────┬─────────────────────╮                      │
+│   │                                      │                │         │ │ # │ bucket │  scopes   │     privileges      │                      │
+│   │                                      │                │         │ ├───┼────────┼───────────┼─────────────────────┤                      │
+│   │                                      │                │         │ │ 0 │ *      │ ╭───┬───╮ │ ╭───┬─────────────╮ │                      │
+│   │                                      │                │         │ │   │        │ │ 0 │ * │ │ │ 0 │ data_reader │ │                      │
+│   │                                      │                │         │ │   │        │ ╰───┴───╯ │ ╰───┴─────────────╯ │                      │
+│   │                                      │                │         │ ╰───┴────────┴───────────┴─────────────────────╯                      │
+╰───┴──────────────────────────────────────┴────────────────┴─────────┴───────────────────────────────────────────────────────────────────────╯
+```
+
+In the access section the wild card `*` means that these credentials have access to all those types of resource.
+To list the credentials of a cluster other than the active cluster you can use the `--clusters` flag.
+
+==== `credentials create`
 
 Creates credentials using the given username and password against the active Capella cluster.
 Note that this command will not work against locally hosted Couchbase Server clusters.