improving new docs;

visible at
www.cvxportfolio.com/en/master/index.html

docs/api.rst

@@ -7,9 +7,7 @@ API documentation
 
     simulator
     policies
-    returns
-    risks
-    costs
+    objective_terms
     constraints
     result
     data

docs/conf.py

@@ -107,6 +107,29 @@
 #
 html_theme = 'pydata_sphinx_theme'
 
+# PYDATA_SPHINX_THEME configuration
+
+html_sidebars = { # disable left sidebar on certain pages
+  "manual": [],
+  "contributing": []
+}
+
+html_theme_options = { # button to let users send PR to GH
+    "use_edit_page_button": True,
+}
+
+html_context = {
+    "github_url": "https://github.com",
+    "github_user": "cvxgrp",
+    "github_repo": "cvxportfolio",
+    "github_version": "master", # don't know if can point to tag of the page?
+    "doc_path": "docs",
+}
+
+# however this seems confusing to me
+# html_show_sourcelink = False
+
+
 # not used by FURO
 # html_theme_options = {
 #     "source_repository": REPO,
@@ -159,7 +182,7 @@
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
     (master_doc, 'cvxportfolio.tex', 'Cvxportfolio Documentation',
-     'The Cvxportfolio Contributors', 'manual'),
+     'The Cvxportfolio Authors and Contributors', 'manual'),
 ]
 
 
@@ -180,6 +203,6 @@
 #  dir menu entry, description, category)
 texinfo_documents = [
     (master_doc, 'cvxportfolio', 'Cvxportfolio Documentation',
-     author, 'cvxportfolio', 'One line description of project.',
+     author, 'cvxportfolio', 'Portfolio Optimization and Back-Testing.',
      'Miscellaneous'),
 ]

docs/constraints.rst

@@ -95,8 +95,8 @@ can not be used as soft constraints. See their documentation for more details.
 Cost inequality as constraint
 -----------------------------
 
-Since version ``0.4.6`` you can use any term described in 
-:ref:`the objective terms page <objective-terms-page>` as part 
+Since version ``0.4.6`` you can use any objective function term,
+such as :doc:`returns`, :doc:`risks`, and :doc:`costs`, as part
 of an inequality constraint. 
 In fact, you can use any linear combination of objective terms.
 For a minimal example see the following risk-constrained policy.