Update docs to be more informative on startup as per issue https://gi…

[cottrell]

…thub.com//issues/351

See #351.

I built the docs but didn't seem to create a diff so I'm assuming there is some doc build in the github pipelines.

[kevin-bates]

Hi @cottrell - thank you for the pull request - this is great information. My only comment is that I wonder if most of this belongs in the Running section: https://jupyter-kernel-gateway.readthedocs.io/en/latest/http-mode.html#running

Either that or I think we should make a point that these updates are relative only to the notebook-http mode and perhaps add an analogous entry for jupyter-websocket mode (which is the default).

Does that sound ok?

[cottrell]

Yes, what is the test for the websocket mode? I can add that in.

[kevin-bates]

Thank you David.

The startup output is a bit quieter...

jupyter kernelgateway --KernelGatewayApp.api=kernel_gateway.jupyter_websocket --port=10100
[KernelGatewayApp] Jupyter Kernel Gateway at http://127.0.0.1:10100

(and this option --KernelGatewayApp.api=kernel_gateway.jupyter_websocket is the default, but listed for completeness.)

You could hit the same swagger endpoint. I also like fetching the set of kernelspecs as a litmus test:

curl http://127.0.0.1:10100/api/kernelspecs

The output is a bunch of JSON that looks much better if piped through jq ( ... | jq).

[cottrell]

Updated again.

[kevin-bates]

Good stuff - thanks David!