Define and document a clear policy to name commands in the command line interface
We are trying to converge towards debusine <concept> <action> but that level of specification is not sufficient for developers to make consistent choices:
- we don't know when a concept is worth a top-level keyword
- ex:
debusine workspace-inheritanceexists but notdebusine-admin rolesordebusine-admin file_store(though workspace inheritance is certainly more closely tied to workspaces than roles)
- ex:
- we are not clear how to handle sub-concepts involving multiple sub-actions
- ex: we have
debusine-admin scope add_file_store|edit_file_store|remove_file_storebut we also havedebusine-admin group members --add|--remove|--setordebusine workspace-inheritance --edit|--append|...
- ex: we have
- some actions are implicit, some are explicit
- ex: listing roles is
debusine workspace list_roles …, but listing members isdebusine-admin group members $group
- ex: listing roles is
Edited by Raphaël Hertzog