Draft: Doc update

.gitignore

@@ -6,6 +6,7 @@ dist/
 tests/__pycache__
 pyttb/__pycache__
 build/
+_build/
 .coverage
 .ipynb_checkpoints
 htmlcov

docs/source/index.rst

@@ -4,16 +4,25 @@ pyttb: Python Tensor Toolbox
 ****************************
 Tensors (also known as multidimensional arrays or N-way arrays) are used
 in a variety of applications ranging from chemometrics to network
-analysis.
+analysis. This Python package is an adaptation of the 
+`Tensor Toolbox for MATLAB <https://www.tensortoolbox.org>`_.
 
--  Install the latest release from pypi (``pip install pyttb``).
 -  This is open source software. Please see `LICENSE`_ for the
    terms of the license (2-clause BSD).
 -  For more information or for feedback on this project, please `contact us`_.
 
 .. _`LICENSE`: ../../../LICENSE
 .. _contact us: #contact
 
+Installing
+==========
+
+* Via pypi
+   -  Install the latest release from pypi (``pip install pyttb``).
+* From source
+   -  Clone the repository from `github <https://github.com/sandialabs/pyttb>`_.
+   -  Install the package with ``pip install .`` from the pyttb root directory.
+
 Functionality
 ==============
 pyttb provides the following classes and functions

docs/source/tensor.rst

@@ -1,8 +1,8 @@
 pyttb.tensor
 --------------------
 
-.. autoclass:: pyttb.tensor
+.. automodule:: pyttb.tensor
     :members:
     :special-members:
-    :exclude-members: __dict__, __weakref__, __slots__, __init__
+    :exclude-members: __dict__, __weakref__, __slots__, __init__, mttv_left, mttv_mid, mttv_right, min_split
     :show-inheritance:

docs/source/tensor_classes.rst

@@ -2,14 +2,14 @@ Tensor Classes
 ==============
 
 .. toctree::
-    :maxdepth: 2
+    :maxdepth: 3
 
-    ktensor.rst
-    sptenmat.rst
-    sptensor.rst
-    sumtensor.rst
-    tensor.rst
-    ttensor.rst
-    tenmat.rst
-    pyttb_utils.rst
+    tensor
+    sptensor
+    ktensor
+    ttensor
+    sumtensor
+    tenmat
+    sptenmat
+    pyttb_utils