docs: use extra requirements for building docs, update docs

Author: Arun Persaud

.readthedocs.yaml

@@ -21,4 +21,6 @@ sphinx:
 python:
    install:
    - method: pip
-     path: .
+     path: .
+     extra_requirements:
+        - docs

docs/source/contributing.md

@@ -8,31 +8,40 @@ The best way to connect with us is to create a github issue.
 
 ## Installing
 
-PyMCNP source code is accessable for contributions, suggestions, and bug reports on [GitHub](https://github.com/FSIBT/PyMCNP). The following command downloads PyMCNP source code and installs `pymcnp` and its dependencies in editable mode:
+PyMCNP source code is accessable for contributions, suggestions, and
+bug reports on [GitHub](https://github.com/FSIBT/PyMCNP). The
+following command downloads PyMCNP source code and installs `pymcnp`
+and its dependencies in editable mode:
 
     git clone https://github.com/FSIBT/PyMCNP
     cd PyMCNP
-    pip install -e .
+    pip install -e .[docs]
 
 ## Code formatting, pre-commit, etc.
 
-If you plan to contribute, you should also enable `pre-commit`
+If you plan to contribute, you should also enable [pre-commit](https://pre-commit.com/):
 
     pip install pre-commit
     # cd into repo
     pre-commit install
 
-from within the top level directory in the git repository. Pre-commit will ensure that the code is formatted using ruff and that it will match the coding style in our repository.
+from within the top level directory in the git repository. Pre-commit
+will ensure that the code is formatted using ruff and that it will
+match the coding style in our repository.
 
 We are happy to receive pull requests on github.
 
 ## Testings
 
-To run the PyMCNP test suite, after clone the PyMCNP GitHub repository, use the following commands to install Pytest ([Docs](https://docs.pytest.org/en/stable/)) inside the PyMCNP directory:
+To run the PyMCNP test suite, after clone the PyMCNP GitHub
+repository, use the following commands to install Pytest
+([Docs](https://docs.pytest.org/en/stable/)) inside the PyMCNP
+directory:
 
     pip install pytest
 
-After instaling `pytest`, test the `pymcnp` package by calling the following commands inside the PyMCNP directory:
+After instaling `pytest`, test the `pymcnp` package by calling the
+following commands inside the PyMCNP directory:
 
     cd PyMCNP
     python -m pytest

docs/source/installation.md

@@ -6,14 +6,27 @@ PyMCNP is available on [PyPI](https://pypi.org/project/pymcnp/) and can be `pip
 
     pip install pymcnp
 
+## Latest Version
+
+The latest pre-release version can be installed directly from Github:
+
+    pip install git+https://github.com/FSIBT/PyMCNP
 
 ## Developer Version
 
-PyMCNP source code is accessable for contributions, suggestions, and bug reports on [GitHub](https://github.com/FSIBT/PyMCNP). The following command downloads PyMCNP source code and installs `pymcnp` and its dependencies in editable mode:
+PyMCNP source code is accessable for contributions, suggestions, and
+bug reports on [GitHub](https://github.com/FSIBT/PyMCNP). The
+following command downloads PyMCNP source code and installs `pymcnp`
+and its dependencies in editable mode:
 
     git clone https://github.com/FSIBT/PyMCNP
     cd PyMCNP
     pip install -e .
 
 
-If you plan to contribute, please also check out the Contribution guidelines.
+To also be able to build the documentation, you should uses
+
+    pip install -e .[docs]
+
+If you plan to contribute, please also check out the [Contribution](contributing.md)
+guidelines.

pyproject.toml

@@ -27,19 +27,22 @@ classifiers = [
     "Topic :: Scientific/Engineering :: Physics",
 ]
 dependencies = [
-    "Sphinx",
     "docopt",
+    "fastparquet",
     "matplotlib",
     "molmass",
-    "myst_parser",
     "numpy",
     "pandas",
     "pytest",
-    "fastparquet",
     "rich",
     "scipy",
+]
+
+[project.optional-dependencies]
+docs = [
+    "myst_parser",
+    "Sphinx",
     "sphinx_rtd_theme",
-    "molmass",
 ]
 
 [project.urls]