Want to edit or update some of our PachCTL CLI documentation? This is a quick guide to help you get started.
List of commands categories and their locations:
taskcmds /src/internal/task/cmds
admincmds /src/server/admin/cmds
authcmds /src/server/auth/cmds
configcmds /src/server/config
debugcmds /src/server/debug/cmds
enterprisecmds /src/server/enterprise/cmds
identitycmds /src/server/identity/cmds
licensecmds /src/server/license/cmds
misccmds /src/server/misc/cmds
pfscmds /src/server/pfs/cmds
ppscmds /src/server/pps/cmds
txncmds /src/server/transaction/cmds
How to Edit
Navigate to the corresponding cmds.go file for the command you want to edit.
Update the Short and Long descriptions for the command you want to edit. Long descriptions can contain examples; this section is also valuable for our external documentation.
How to Test the Pachctl CLI's docs output
Navigate to /src/server/cmd/pachctl and run go build.
Execute ./pachctl to see the updated CLI and interact with it.
Explore other command outputs in the same way you normally would, for example: ./pachctl list, ./pachctl put file, etc.
How to Build the Pachctl CLI Markdown documentation
Navigate to /src/server/cmd/pachctl-doc and run go build.
Execute ./pachctl-doc to generate documentation in a ./docs folder
Move the contents of that folder to the docs-content repo's latest release (/run-commands directory).