docs: Notes on prerelease versions

Author: tony

README.md

@@ -34,6 +34,24 @@ machines or want to clone / update a pattern of repos without having to
 $ pip install --user vcspull
 ```
 
+### Developmental releases
+
+You can test the unpublished version of vcspull before its released.
+
+- [pip](https://pip.pypa.io/en/stable/):
+
+  ```console
+  $ pip install --user --upgrade --pre vcspull
+  ```
+
+- [pipx](https://pypa.github.io/pipx/docs/):
+
+  ```console
+  $ pipx install --suffix=@next 'vcspull' --pip-args '\--pre' --force
+  ```
+
+  Then use `vcspull@next sync [config]...`.
+
 ## configure
 
 add repos you want vcspull to manage to `~/.vcspull.yaml`.

docs/quickstart.md

@@ -4,23 +4,56 @@
 
 ## Installation
 
-First, install vcspull.
-
 For latest official version:
 
 ```console
-
 $ pip install --user vcspull
-
 ```
 
-Development version:
+Upgrading:
 
 ```console
+$ pip install --user --user vcspull
+```
 
-$ pip install --user -e git+https://github.com/vcs-python/vcspull.git#egg=vcspull
+(developmental-releases)=
 
-```
+### Developmental releases
+
+New versions of vcspull are published to PyPI as alpha, beta, or release candidates.
+In their versions you will see notfication like `a1`, `b1`, and `rc1`, respectively.
+`1.10.0b4` would mean the 4th beta release of `1.10.0` before general availability.
+
+- [pip]\:
+
+  ```console
+  $ pip install --user --upgrade --pre vcspull
+  ```
+
+- [pipx]\:
+
+  ```console
+  $ pipx install --suffix=@next 'vcspull' --pip-args '\--pre' --force
+  ```
+
+  Then use `vcspull@next sync [config]...`.
+
+via trunk (can break easily):
+
+- [pip]\:
+
+  ```console
+  $ pip install --user -e git+https://github.com/vcs-python/vcspull.git#egg=vcspull
+  ```
+
+- [pipx]\:
+
+  ```console
+  $ pipx install --suffix=@master 'vcspull @ git+https://github.com/vcs-python/vcspull.git@master' --force
+  ```
+
+[pip]: https://pip.pypa.io/en/stable/
+[pipx]: https://pypa.github.io/pipx/docs/
 
 ## Configuration