`ckan shell` command is not documented

[amercader]

The very useful ckan shell command introduced in 2.10 (https://github.com/ckan/ckan/pull/6919) is not mentioned anywhere in the docs.

It should be at least mentioned in https://docs.ckan.org/en/2.10/maintaining/cli.html

[amercader]

Even better would be to autogenerate our CLI docs using the actual docsttrings of the ckan commands

[boydjohnson]

Hi @amercader, I was looking into using sphinx-click to do this. There is a long-standing issue in sphinx-click/sphinx around referencing a program. The examples in sphinx-click use a URL and path, like

.. |Command| replace:: ``Command``
.. _Command: https://click.palletsprojects.com/en/7.x/api/#click.Command

Are the ckan docs hosted only at one URL?

[vishal-agr99]

Hi @amercader I want to work on this issue. I will submit a PR for this.