Initial support for argcomplete for KVArgParseConfigLoader

CHANGELOG.md

@@ -2,6 +2,18 @@
 
 <!-- <START NEW CHANGELOG ENTRY> -->
 
+## 5.8.0
+
+### Enhancements made
+
+- Shell command-line tab-completion via `argcomplete` [#811](https://github.com/ipython/traitlets/pull/811) ([@azjps](https://github.com/azjps))
+
+### Maintenance and upkeep improvements
+
+- Additional `Application` examples and docs [#811](https://github.com/ipython/traitlets/pull/811) ([@azjps](https://github.com/azjps))
+
+<!-- <END NEW CHANGELOG ENTRY> -->
+
 ## 5.7.1
 
 ([Full Changelog](https://github.com/ipython/traitlets/compare/v5.7.0...aa0d38bf02d34a6df788477da30eac6e58ffbda5))
@@ -16,8 +28,6 @@
 
 [@maartenbreddels](https://github.com/search?q=repo%3Aipython%2Ftraitlets+involves%3Amaartenbreddels+updated%3A2022-12-08..2022-12-12&type=Issues)
 
-<!-- <END NEW CHANGELOG ENTRY> -->
-
 ## 5.7.0
 
 ([Full Changelog](https://github.com/ipython/traitlets/compare/v5.6.0...f07afea52cf6314bc20571c52409ff6cb115a709))

docs/readme-docs.md

@@ -1,47 +1,38 @@
 # Documenting traitlets
 
-[Documentation for `traitlets`](https://traitlets.readthedocs.io/en/latest/)
-is hosted on ReadTheDocs.
+[Documentation for `traitlets`](https://traitlets.readthedocs.io/en/latest/) is hosted on ReadTheDocs.
 
 ## Build documentation locally
 
-#### Change directory to documentation root:
+With [`hatch`](https://hatch.pypa.io/), one can build environments, docs, and serve it in one command:
 
 ```
-cd docs
+pip install hatch
+hatch run docs:build
 ```
 
-#### Create environment
+#### Build documentation manually
 
-- \[**conda**\] Create conda env (and install relevant dependencies):
+Otherwise to build docs manually,
 
-  ```
-    conda env create -f environment.yml
-  ```
+```
+cd docs
+```
 
-- \[**pip**\] Create virtual environment (and install relevant dependencies):
+Create virtual environment (and install relevant dependencies):
 
-  ```
+```
     virtualenv traitlets_docs -p python3
-    pip install -r requirements.txt
-  ```
-
-#### Activate the newly built environment `traitlets_docs`
-
-- \[**conda**\] Activate conda env:
-
-  ```
-    source activate traitlets_docs
-  ```
+    pip install -r traitlets[docs]
+```
 
-- \[**pip**\] The virtualenv should have been automatically activated. If
-  not:
+The virtualenv should have been automatically activated. If not:
 
-  ```
-    source activate
-  ```
+```
+source activate
+```
 
-#### Build documentation using:
+##### Build documentation using:
 
 - Makefile for Linux and OS X:
 
@@ -55,7 +46,7 @@ cd docs
     make.bat html
   ```
 
-#### Display the documentation locally
+##### Display the documentation locally
 
 - Navigate to `build/html/index.html` in your browser.
 
@@ -77,5 +68,3 @@ cd docs
 - `source/conf.py` - Sphinx build configuration file
 - `source` directory - source for documentation
 - `source/index.rst` - Main landing page of the Sphinx documentation
-- `requirements.txt` - list of packages to install when using pip
-- `environment.yml` - list of packages to install when using conda