doc: more descriptions

Author: SYMSCAE

.github/workflows/build-and-publish-docs-on-dispatch.yml

@@ -15,6 +15,8 @@ jobs:
       project: libdiffpy
       c_extension: true
       headless: false
+      # true: install the project with `python -m pip install -e . --no-deps`.
+      # false: skip project installation; still install dependencies and build docs.
       # libdiffpy is a C++ library and does not need a Python package installed for docs.
       install_project: false
       python_version: ${{ fromJSON(needs.get-python-version.outputs.latest_python_version) }}

.github/workflows/release-github-on-tag.yml

@@ -39,6 +39,8 @@ jobs:
       project: libdiffpy
       c_extension: true
       headless: false
+      # true: install the project with `python -m pip install -e . --no-deps`.
+      # false: skip project installation; still install dependencies and build docs.
       # libdiffpy is a C++ library and does not need a Python package installed for docs.
       install_project: false
       python_version: 0