From e4c679058be956bd9910592150101d17b8c5c0e8 Mon Sep 17 00:00:00 2001
From: Alejandro Saucedo <axsauze@gmail.com>
Date: Sun, 30 Aug 2020 15:32:16 +0100
Subject: [PATCH] Updated documentation to include multiple sections

---
 README.md                           |   2 +-
 docs/conf.py                        |   5 +-
 docs/genindex.rst                   |   4 ++
 docs/images/suspicious.jfif         | Bin 0 -> 14385 bytes
 docs/index.rst                      | 106 +++-------------------------
 docs/overview/memory-management.rst |  14 ++++
 docs/overview/reference.rst         |  83 ++++++++++++++++++++++
 7 files changed, 115 insertions(+), 99 deletions(-)
 create mode 100644 docs/genindex.rst
 create mode 100755 docs/images/suspicious.jfif
 create mode 100755 docs/overview/memory-management.rst
 create mode 100644 docs/overview/reference.rst

diff --git a/README.md b/README.md
index c8650b4e1..b749a6c2b 100644
--- a/README.md
+++ b/README.md
@@ -176,7 +176,7 @@ Simplified Kompute Components
 <br>
 <br>
 
-<img width="100%" src="https://www.memesmonkey.com/images/memesmonkey/a2/a29e06384bf8981e7ae66d5150383f6e.jpeg">
+<img width="100%" src="raw.githubusercontent.com/axsaucedo/vulkan-kompute/master/docs/images/suspicious.jfif">
 
 </td>
 <td>
diff --git a/docs/conf.py b/docs/conf.py
index 6b3384139..a6a3de48f 100755
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -51,7 +51,6 @@ templates_path = ['_templates']
 # This pattern also affects html_static_path and html_extra_path.
 exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
 
-
 # -- Options for HTML output -------------------------------------------------
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
@@ -76,6 +75,10 @@ if html_theme == 'sphinx_material':
         'globaltoc_includehidden': False,
     }
 
+html_sidebars = {
+    "**": ["logo-text.html", "globaltoc.html", "searchbox.html"]
+}
+
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
diff --git a/docs/genindex.rst b/docs/genindex.rst
new file mode 100644
index 000000000..4eef4a23b
--- /dev/null
+++ b/docs/genindex.rst
@@ -0,0 +1,4 @@
+.. This file is a placeholder and will be replaced
+
+Code index
+##########
diff --git a/docs/images/suspicious.jfif b/docs/images/suspicious.jfif
new file mode 100755
index 0000000000000000000000000000000000000000..1e745575023131aea37163fd17cf2495d84d4e2b
GIT binary patch
literal 14385
zcmch-1yoz@x-J@u1gEq>fdZkpTah9qr4)h`DDKb}FYZzxNYNt2TUs27Cb$=OcPQ@e
z9w3C1{(JxHu6@S3<E(wgzIP7Z`OPqA=KP+SSD*L0`+c_rxUV29FAKoHzySQU-7N!N
z%6M3r0{}`&01ouOZ~+)0RsbyY(Vr`*|GMbj3jhEUeS`t<1OQ%O{B`C(zyIg_-7G*F
zK!Aq_{Ob=74}JJ&BfujdAS6Hw(S1TvVj^O~2UHK3scD&MsX#RB>=eu*Lc-J>0+QV9
zd{p939{#xr1`rn){Vj3=0&*@|Dq61p_IB3{AjQRC!<fOuU;x}B#lR%RxN8T1&@;zI
zBmM_y^yhn+SlBo~Ts(XN^aYjo0rxO4G4EkvVq;^Wp=0=<&jYYXu^&9)m%@3d`VPq8
zNG9MPlYz_lvb2R<ZRCjQ>3gRDJba2rlvLErEUawo9D+i^BF{v{q+iL%LgeHX)HO7<
zv~_g#OiazpEiA1*IJ>yIxqEne1%3(&4hanlkBy5@NKE?rEjcqQJLhL^UVcGYc|~Pa
zbxmzuYg>CqXIFPm@95b0#N^cP>6zt~)wT7F&8_X7<CD{~^NUNw)%71-7y!)wfb|b#
z{~In+G_HGCSeRJAKe#aNx&Hx9iiQ1zALoITD)61-Lk0nVT(Xxj8Ko_Fj8D~$$lp7S
z;8QROE;Aqhf%X@&e-Bu|{}r--0Q-M%%>W27G0;CACMf_6ShD<C*hSwfP;w!f1B-gV
zN#)z-t6CGhOAz-vu4QN{eCrDSVTV_kF}g8L;0~awPi?z6v#<IUbs+)a&8K%*jI>tJ
zx|D-GhC3Z7Q3<N*|7eLbn4O)g%5gQxC1o`7j!L&MU#$(~-;Ua-6ylunS6i5)sIO`5
zED-3WT&4F)ofx*%6R^^{$;K$Q0L+06(@)p)FAjICyZetvTHAir(H*EJ4LuTXU>r}A
z8(ki?_5Sq!q+5DUevtM!I-btY4Mvm9R_vdzrfIq<;x;srKNiWBC#6f@lf@Fw`Sit~
zferBg<NjV0?1R0_?2Qd_h(N&g<`}s<mO9aE#Uzx>$Tv?QVPWTx?u`r(J2f0|_;Lrx
z+?nZ!8cvsp_)*$D|HV`CllFwexwWX;RT_IcnM<T`Og1Ca7u-Dusczs;2mb3(+(9`m
zK4QF0$!v`9mz%@HDI!k%5l+5MDLAjc%tD-7-t`<#Hnyp+y&xL!bKoQCcaB&chAOB(
zW@9Q@1yb6a?(lc5${GA11Yl4CQd7U>Ja`*d;T&;K$3I%n%g+Y9X!PmKcmAUq+o0Fx
zGs-nW!XJK5W$yr*>c7u7f27`SEy%0ASe4AWq80+oIOsbpSx}00I;MWj?#cLC!U%98
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
be;&#?EAiq#AD+7hRT)>6VG)Ew@23A3D<~wV

literal 0
HcmV?d00001

diff --git a/docs/index.rst b/docs/index.rst
index 35a411b92..995b56cf7 100755
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,105 +1,17 @@
-.. Vulkan Kompute documentation master file, created by
-   sphinx-quickstart on Fri Aug 28 06:42:00 2020.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
 
-Welcome to Vulkan Kompute's documentation!
+Kompute Docs Home
 ==========================================
 
 .. mdinclude:: ../README.md
 
+Index
+--------
+
 .. toctree::
-   :maxdepth: 2
-   :caption: Contents:
+    :maxdepth: 2
+    :titlesonly:
 
+    Class Reference <overview/reference>
+    Memory management principles <overview/memory-management>
+    Code Index <genindex>
 
-Reference
-========
-
-You can also go directoy to the `raw doxygen docs <doxygen/annotated.html>`_
-
-Overview of entire dependencies and their relationship with vulkan component ownership.
-
-.. image:: images/kompute-vulkan-architecture.jpg
-   :width: 100%
-
-Manager
--------
-
-.. doxygenclass:: kp::Manager
-   :members:
-
-.. image:: images/kompute-vulkan-architecture-manager.jpg
-   :width: 100%
-
-Sequence
--------
-
-.. doxygenclass:: kp::Sequence
-   :members:
-
-.. image:: images/kompute-vulkan-architecture-sequence.jpg
-   :width: 100%
-
-Tensor
--------
-
-.. doxygenclass:: kp::Tensor
-   :members:
-
-.. image:: images/kompute-vulkan-architecture-tensor.jpg
-   :width: 100%
-
-Algorithm
--------
-
-.. doxygenclass:: kp::Algorithm
-   :members:
-
-.. image:: images/kompute-vulkan-architecture-algorithm.jpg
-   :width: 100%
-
-OpBase
--------
-
-.. doxygenclass:: kp::OpBase
-   :members:
-
-.. image:: images/kompute-vulkan-architecture-operations.jpg
-   :width: 100%
-
-OpAlgoBase
--------
-
-.. doxygenclass:: kp::OpAlgoBase
-   :members:
-
-.. image:: images/kompute-vulkan-architecture-opmult.jpg
-   :width: 100%
-
-OpMult
--------
-
-.. doxygenclass:: kp::OpMult
-   :members:
-
-.. image:: images/kompute-vulkan-architecture-opmult.jpg
-   :width: 100%
-
-OpCreateTensor
--------
-
-.. doxygenclass:: kp::OpCreateTensor
-   :members:
-
-.. image:: images/kompute-vulkan-architecture-opcreatetensor.jpg
-   :width: 100%
-
-
-
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
diff --git a/docs/overview/memory-management.rst b/docs/overview/memory-management.rst
new file mode 100755
index 000000000..693214682
--- /dev/null
+++ b/docs/overview/memory-management.rst
@@ -0,0 +1,14 @@
+
+Memory Management Principles
+=====================
+
+The principle in Vulkan Kompute on memory management is summarised as follows:
+* Explicit is better than implicit for specifying memory management 
+* Interfaces for memory management are constant until freed
+* Memory management responsibilities are acyclic from static object references
+
+Vulkan Kompute is responsible for managing both the CPU and GPU memory allocations and resources, and is important that they are able to explicitly define when these objects are released or destroyed. Similarly, it's important that the memory resources created by the application are released safely.
+
+Vulkan Kompute is built with the BYOV principle in mind (Bring your own Vulkan). This means that even though the top level resources are managing the memory to its owned resources, they themselves may not have full ownership of the GPU / Vulkan components themselves.
+
+
diff --git a/docs/overview/reference.rst b/docs/overview/reference.rst
new file mode 100644
index 000000000..6711f680d
--- /dev/null
+++ b/docs/overview/reference.rst
@@ -0,0 +1,83 @@
+
+Reference
+========
+
+This section provides a breakdown of the cpp classes and what each of their functions provide. It is partially generated and augomented from the Doxygen autodoc content. You can also go directly to the `raw doxygen docs <doxygen/annotated.html>`_.
+
+Below is a diagram that provides insights on the relationship between Vulkan Kompute objects and Vulkan resources, which primarily encompass ownership of either CPU and/or GPU memory.
+
+.. image:: ../images/kompute-vulkan-architecture.jpg
+   :width: 100%
+
+Manager
+-------
+
+.. doxygenclass:: kp::Manager
+   :members:
+
+.. image:: ../images/kompute-vulkan-architecture-manager.jpg
+   :width: 100%
+
+Sequence
+-------
+
+.. doxygenclass:: kp::Sequence
+   :members:
+
+.. image:: ../images/kompute-vulkan-architecture-sequence.jpg
+   :width: 100%
+
+Tensor
+-------
+
+.. doxygenclass:: kp::Tensor
+   :members:
+
+.. image:: ../images/kompute-vulkan-architecture-tensor.jpg
+   :width: 100%
+
+Algorithm
+-------
+
+.. doxygenclass:: kp::Algorithm
+   :members:
+
+.. image:: ../images/kompute-vulkan-architecture-algorithm.jpg
+   :width: 100%
+
+OpBase
+-------
+
+.. doxygenclass:: kp::OpBase
+   :members:
+
+.. image:: ../images/kompute-vulkan-architecture-operations.jpg
+   :width: 100%
+
+OpAlgoBase
+-------
+
+.. doxygenclass:: kp::OpAlgoBase
+   :members:
+
+.. image:: ../images/kompute-vulkan-architecture-opmult.jpg
+   :width: 100%
+
+OpMult
+-------
+
+.. doxygenclass:: kp::OpMult
+   :members:
+
+.. image:: ../images/kompute-vulkan-architecture-opmult.jpg
+   :width: 100%
+
+OpCreateTensor
+-------
+
+.. doxygenclass:: kp::OpCreateTensor
+   :members:
+
+.. image:: ../images/kompute-vulkan-architecture-opcreatetensor.jpg
+   :width: 100%
+