Add a warning explaining that the api docs are duplicated [ci skip] (#302)

Author: eric-wieser

doc/module-components.rst

@@ -1,6 +1,21 @@
 Module Components
 =================
 
+.. warning::
+
+   This page is converted from the original :math:`\LaTeX` documentation, but
+   may no longer reflect the current state of the library. See the API docs at
+   :doc:`api` for more up-to-date but less structured and in-depth descriptions.
+
+   If you would like to help with merging the descriptions on the API with a
+   description on this page, please head over to :issue:`300` on GitHub, where
+   there's an explanation of how to do so. Even merging just one function
+   explanation helps!
+
+   Any function or class below with a ``[source]`` link to its right is
+   guaranteed to be up-to-date already, as its documentation is identical on
+   both pages.
+
 The geometric algebra module consists of the following files and classes
 
 +----------------+--------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+

galgebra/__init__.py

@@ -1,4 +1,4 @@
-"""
+r"""
 .. currentmodule:: galgebra
 ========================================
 galgebra (:mod:`galgebra`)
@@ -19,6 +19,17 @@
     dop
     printer
     utils
+
+.. note::
+
+    Some functions may be better documented by the original non-generated docs
+    on the :doc:`module-components` page, but there is a risk the descriptions
+    there are outdated.
+
+    If you would like to help with merging the descriptions here with a
+    description on that page, please head over to :issue:`300` on GitHub, where
+    there's an explanation of how to do so. Even merging just one function
+    explanation helps!
 """
 
 from ._version import __version__  # noqa: F401