sphinx formatting change and fix CLI docs (#5032)

* sphinx formatting change.

* minor doc formatting improvements.

* check point progress

* Get the CLI docs generating again.

* Add news item for fixed CLI documentation.

* Dont skip build of docs changes.

* fix linting

.github/workflows/ci.yaml

@@ -3,7 +3,6 @@ name: CI
 on:
   push:
     paths-ignore:
-      - "docs/**"
       - "news/**"
       - "examples/**"
       - "peeps/**"
@@ -19,7 +18,6 @@ on:
       - main
   pull_request:
     paths-ignore:
-      - "docs/**"
       - "news/**"
       - "examples/**"
       - "peeps/**"