Now sphinx-build works (toc spacing matters!)

convexengineering · Jun 25, 2019 · df33586 · df33586
1 parent 15d2930
commit df33586
Show file tree

Hide file tree

Showing 2 changed files with 25 additions and 21 deletions.
diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -3,17 +3,16 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to robust's documentation!
+Welcome to **robust**'s documentation!
 ==================================
 
-robust is a framework for engineering system optimization
+**robust** is a framework for engineering system optimization
 under uncertainty using geometric and signomial programming. 
 
 Robust optimization is a tractable stochastic optimization
 method that protects against uncertain parameters in 
 well-defined sets, and optimizes for the worst case objective. 
 
-
 This website is under construction. If you have 
 a GP model that you would like to robustify but are not able to find answers to your questions in the documentation,
 please feel free to post `issues <https://github.com/convexengineering/robust/issues>`_
@@ -22,15 +21,15 @@ and suggest areas for improvement.
 Table of contents:
 
 .. toctree::
-    :maxdepth: 2
-    
-		robust101
-        installation
-        whyro
-   		methods
-   		math
-   		goal
-   		references
+   :maxdepth: 2
+
+   robust101
+   installation
+   whyro
+   methods
+   math
+   goal
+   references
 
 Indices and tables
 ==================

diff --git a/docs/source/whyro.rst b/docs/source/whyro.rst
@@ -3,23 +3,28 @@ Why robust optimization?
 
 Firstly we should ask, why optimization under uncertainty? 
 
+Comparison of general SO methods with RO
+========================================
 
 
-SPaircraft is a signomial programming compatible transonic aircraft conceptual design optimization tool.
-It is of similar level of fidelity as TASOPT, and can perform the single- and multi-mission optimization of many
-different configurations of aircraft.
-
-    * `Efficient and Reliable Aircraft Multidisciplinary
-Design Optimization via Signomial Programming
-<http://hoburg.mit.edu/publications/SP_tasopt_watermark.pdf>`_ extends these models to multiple
-aircraft configurations, and demonstrates the advantages of SPaircraft relative to other existing
-multidisciplinary design optimization tools.
 
 Advantages of RO over SO
 ========================
 
 Tractability
 ------------
 
+In general, SO methods are intractable due to the nature of
+and methods for uncertainty propagation. The propagation of probability distributions of parameters through physics
+requires the integration of PDFs with objective and constraint
+outcomes. Since this is difficult, this is often achieved 
+through high-dimensional quadrature and the enumeration of
+potential outcomes into scenarios. 
+
 Probabilistic guarantees
 ------------------------
+
+RO methods give probabilistic guarantees of constraint
+satisfaction for uncertain outcomes within a 
+defined uncertainty set. 
+