gohugoio / hugo

The world’s fastest framework for building websites.
https://gohugo.io
Apache License 2.0
75.4k stars 7.49k forks source link

commands: Use consistent style when describing subcommands #12897

Closed jmooring closed 5 days ago

jmooring commented 2 weeks ago

This is a nit. I suggest that we:

current

Available Commands:
  build       build builds your site
  completion  Generate the autocompletion script for the specified shell
  config      Print the site configuration
  convert     Convert your content to different formats
  deploy      Deploy your site to a Cloud provider.
  env         Print Hugo version and environment info
  gen         A collection of several useful generators.
  help        Help about any command
  import      Import your site from others.
  list        Listing out various types of content
  mod         Various Hugo Modules helpers.
  new         Create new content for your site
  server      A high performance webserver
  version     Print Hugo version and environment info

suggested

Available Commands:
  build       Build your site
  completion  Generate an autocompletion script for the specified shell
  config      Display site configuration
  convert     Convert front matter to another format
  deploy      Deploy your site to a cloud provider
  env         Display version and environment info
  gen         Generate documentation and syntax highlighting styles
  help        Display help about any command
  import      Import a site from another system
  list        List content
  mod         Manage modules
  new         Create new content
  server      Start the embedded web server
  version     Display version

Make similar changes to child subcommands.

Hasaber8 commented 6 days ago

Not sure if it picked up yet or not, but I have raised an PR for it; https://github.com/gohugoio/hugo/pull/12931