justinmclean commented on code in PR #5293:
URL: https://github.com/apache/gravitino/pull/5293#discussion_r1846132354


##########
docs/cli.md:
##########
@@ -506,6 +507,26 @@ gcli tag update --tag tagA --rename newTag
 gcli tag update --tag tagA --comment "new comment"
 ```
 
+### Owners commands
+
+#### List an owner
+
+```bash
+gcli catalog details --name postgres --owner
+```
+
+#### Set an owner to a user
+
+```bash
+gcli catalog set --name postgres --user admin

Review Comment:
   `set-owner` doesn't align with that advice as it's inconsistent with the 
verbs used for different types of objects. In this case, more sub-commands 
means that the code needs to be duplicated for every entity rather than working 
off a single flag. Having a single flag means it will be future-proof as well 
as if new entities are added as no new code is needed, while a command will 
mean new code will need to be added for each new entiry added.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscr...@gravitino.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org

Reply via email to