Documentation update
Change-Id: I0fec43bff4fe0ea6cd2d2a8b34dac2330a517da0
diff --git a/docs/source/modeling.rst b/docs/source/modeling.rst
index c816676..34c3bf8 100644
--- a/docs/source/modeling.rst
+++ b/docs/source/modeling.rst
@@ -1,9 +1,7 @@
.. default-domain:: cpp
-
.. cpp:namespace:: ceres
-
.. _`chapter-modeling`:
============
@@ -30,6 +28,15 @@
that is used to reduce the influence of outliers on the solution of
non-linear least squares problems.
+In this chapter we will describe the various classes that are part of
+Ceres Solver's modeling API, and how they can be used to construct
+optimization.
+
+Once a problem has been constructed, various methods for solving them
+will be discussed in :ref:`chapter-solving`. It is by design that the
+modeling and the solving APIs are orthogonal to each other. This
+enables easy switching/tweaking of various solver parameters without
+having to touch the problem once it has been successfuly modeling.
:class:`CostFunction`
---------------------
