From 96901068ab230225cf1f9b606a56fb216abedb8b Mon Sep 17 00:00:00 2001
From: Ray R <info@enlivn.io>
Date: Sat, 28 Oct 2023 20:55:16 -0700
Subject: [PATCH] chore: add documentation to download and install Ecoscope
 GUI.

---
 doc/source/abc.md           |  1 +
 doc/source/conf.py          |  7 +++++++
 doc/source/ecoscope_gui.rst | 31 +++++++++++++++++++++++++++++++
 doc/source/index.rst        |  4 +++-
 environment.yml             |  1 +
 5 files changed, 43 insertions(+), 1 deletion(-)
 create mode 100644 doc/source/abc.md
 create mode 100644 doc/source/ecoscope_gui.rst

diff --git a/doc/source/abc.md b/doc/source/abc.md
new file mode 100644
index 00000000..0a901256
--- /dev/null
+++ b/doc/source/abc.md
@@ -0,0 +1 @@
+Testing
\ No newline at end of file
diff --git a/doc/source/conf.py b/doc/source/conf.py
index 15147c28..5f206074 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -26,6 +26,12 @@
 copyright = "2022, Wildlife Dynamics"
 author = "Wildlife Dynamics"
 
+source_suffix = {
+    '.rst': 'restructuredtext',
+    '.txt': 'restructuredtext',
+    '.md': 'markdown',
+}
+
 
 # -- General configuration ---------------------------------------------------
 
@@ -41,6 +47,7 @@
     "sphinx.ext.intersphinx",
     "sphinx.ext.napoleon",
     "sphinx.ext.viewcode",
+    "myst_parser",
 ]
 
 nbsphinx_execute = "never"
diff --git a/doc/source/ecoscope_gui.rst b/doc/source/ecoscope_gui.rst
new file mode 100644
index 00000000..229be935
--- /dev/null
+++ b/doc/source/ecoscope_gui.rst
@@ -0,0 +1,31 @@
+Ecoscope GUI
+============
+
+The Ecoscope GUI provides a cross-platform, easy-to-use graphical user interface to be able to filter events and subject group observations from your EarthRanger instance, and process them with Ecoscope.
+
+The downloaded data can then be exported as either a geopackage (``.gpkg``) or a CSV (``.csv``) file.
+
+<insert screenshot>
+
+Downloads
+---------
+Requirements
+~~~~~~~~~~~~
+The GUI can be run on the following operating systems:
+
+==  ================
+OS  CPU architecture
+==  ================
+False  False
+True   False
+False  True
+True   True
+=====  ============
+
+
+===== =====
+OS    CPU architecture
+===== =====
+Windows 11 64-bit
+| --- | --- |
+| a | b
\ No newline at end of file
diff --git a/doc/source/index.rst b/doc/source/index.rst
index ea9f65cc..bb1c9810 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -6,4 +6,6 @@
    :hidden:
 
    Home <self>
-   notebooks
\ No newline at end of file
+   notebooks;
+   ecoscope_gui
+   abc
\ No newline at end of file
diff --git a/environment.yml b/environment.yml
index 70a7cc7f..80ef7a04 100644
--- a/environment.yml
+++ b/environment.yml
@@ -49,4 +49,5 @@ dependencies:
     - nbsphinx-multilink==1.4.1
     - sphinx-autoapi==3.0.0
     - earthranger-client==1.0.49
+    - myst-parser==2.0.0