diff --git a/README.rst b/README.rst
index 6188cbe..eb0422b 100644
--- a/README.rst
+++ b/README.rst
@@ -37,7 +37,7 @@
surface-apps
============
-Surface detection within geoscientific data.
+The **surface-apps** library offers tools for the creation and manipulation of surface objects using various Python libraries and `geoh5py `_.
.. contents:: Table of Contents
:local:
@@ -65,7 +65,7 @@ Within a conda environment
--------------------------
You can install (or update) a conda environment with all the requires packages to run **surface-apps**.
-To do so you can directly run the **Install_or_Update.bat** file by double left clicking on it.
+To do so you can directly run the **install.bat** file by double left clicking on it.
Install with conda
------------------
@@ -156,7 +156,7 @@ The use of Third Party Software is governed by the terms of such software licens
Third Party Software notices and/or additional terms and conditions are located in the
`THIRD_PARTY_SOFTWARE.rst`_ file.
-.. _THIRD_PARTY_SOFTWARE.rst: THIRD_PARTY_SOFTWARE.rst
+.. _THIRD_PARTY_SOFTWARE.rst: ./docs/source/THIRD_PARTY_SOFTWARE.rst
Copyright
^^^^^^^^^
diff --git a/THIRD_PARTY_SOFTWARE.rst b/docs/source/THIRD_PARTY_SOFTWARE.rst
similarity index 88%
rename from THIRD_PARTY_SOFTWARE.rst
rename to docs/source/THIRD_PARTY_SOFTWARE.rst
index d94fce8..5f4fd69 100644
--- a/THIRD_PARTY_SOFTWARE.rst
+++ b/docs/source/THIRD_PARTY_SOFTWARE.rst
@@ -1,4 +1,7 @@
-The my-app repository and source distributions bundle several libraries that are
+Third Party Software
+====================
+
+The surface-apps repository and source distributions bundle several libraries that are
compatibly licensed. We list these here.
.. list-table::
@@ -26,6 +29,6 @@ compatibly licensed. We list these here.
* - `tqdm `_
- MPL-2.0 or MIT
- A Fast, Extensible Progress Bar for Python and CLI
- * - `scikit-image `_
+ * - `scikit-image `_
- BSD-3-Clause
- Image processing in Python
diff --git a/docs/source/conf.py b/docs/source/conf.py
index d33ec55..24118d0 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -7,25 +7,30 @@
# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
import sys
-from datetime import datetime
from pathlib import Path
+
+from datetime import datetime
from importlib.metadata import version
+
from packaging.version import Version
+
sys.path.insert(0, Path("../..").resolve())
project = "surface-apps"
author = "Mira Geoscience Ltd."
project_copyright = "%Y, Mira Geoscience Ltd"
-
-# -- General configuration ---------------------------------------------------
-# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
+copyright = "Mira Geoscience Ltd"
# The full version, including alpha/beta/rc tags.
release = version("surface-apps")
# The shorter X.Y.Z version.
version = Version(release).base_version
+
+# -- General configuration ---------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
+
autodoc_mock_imports = [
"numpy",
"geoh5py",
@@ -43,16 +48,17 @@
# -- Options for HTML output -------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
-
html_theme = "alabaster"
html_theme_options = {
- 'description': f"version {release}",
+ "description": f"version {release}",
}
-html_static_path = ["_static"]
+html_static_path = []
+
def get_copyright_notice():
return f"Copyright {datetime.now().strftime(project_copyright)}"
+
rst_epilog = f"""
.. |copyright_notice| replace:: {get_copyright_notice()}.
"""
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 5c86af1..050e6a2 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -25,6 +25,7 @@ Content
usage
iso_surfaces
api_reference
+ THIRD_PARTY_SOFTWARE
License
@@ -42,16 +43,6 @@ GNU Lesser General Public License for more details.
A copy of the GNU Lesser General Public License can be accessed from .
-Third Party Software
-^^^^^^^^^^^^^^^^^^^^
-The surface-apps Software may provide links to third party libraries or code (collectively “Third Party Software”)
-to implement various functions. Third Party Software does not comprise part of the Software.
-The use of Third Party Software is governed by the terms of such software license(s).
-Third Party Software notices and/or additional terms and conditions are located in the
-`THIRD_PARTY_SOFTWARE`_ file.
-
-.. _THIRD_PARTY_SOFTWARE: THIRD_PARTY_SOFTWARE.rst
-
Copyright
^^^^^^^^^
|copyright_notice|
diff --git a/package.rst b/package.rst
new file mode 100644
index 0000000..4006f2c
--- /dev/null
+++ b/package.rst
@@ -0,0 +1,59 @@
+Surface-apps
+============
+
+The **surface-apps** library offers tools for the creation and manipulation of surface objects using various Python libraries and `geoh5py `_.
+
+Installation
+^^^^^^^^^^^^
+**Surface-apps** is currently written for Python 3.10 or higher.
+
+Install **surface-apps** from PyPI::
+
+ $ pip install surface-apps
+
+
+Feedback
+^^^^^^^^
+Have comments or suggestions? Submit feedback through `Mira Geoscience Support portal `_.
+
+Visit `Mira Geoscience website `_ to learn more about our products
+and services.
+
+
+License
+^^^^^^^
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+Third Party Software
+^^^^^^^^^^^^^^^^^^^^
+The surface-apps Software may provide links to third party libraries or code (collectively “Third Party Software”)
+to implement various functions. Third Party Software does not comprise part of the Software.
+The use of Third Party Software is governed by the terms of such software license(s).
+Third Party Software notices and/or additional terms and conditions are located in the
+`THIRD_PARTY_SOFTWARE.rst`_ file.
+
+.. _THIRD_PARTY_SOFTWARE.rst: docs/source/THIRD_PARTY_SOFTWARE.rst
+
+
+Copyright
+^^^^^^^^^
+Copyright (c) 2022-2025 Mira Geoscience Ltd.