Diff from to

# doxygen/reference.dox

 not included by default in the linker, Python or Matlab paths by
 default. This is specially critical when building shared libraries
 (mandatory for Python usage). The script \em exportlocalpaths.sh makes
-sure that the folder is included in all the necessary paths.
+sure that the folder with the libraries is included in all the
+necessary paths.

 After that, there are 3 steps that should be follow:
 \li Define the function to optimize.
 \section params Understanding the parameters

 BayesOpt relies on a complex and highly configurable mathematical
-model. Also, the key to nonlinear optimization is to include as much
-knowledge as possible about the target function or about the
-problem. Or, if the knowledge is not available, keep the model as
-general as possible (to avoid bias).
+model. In theory, it should work reasonably well for many problems in
+its default configuration. However, Bayesian optimization shines when
+we can include as much knowledge as possible about the target function
+or about the problem. Or, if the knowledge is not available, keep the
+model as general as possible (to avoid bias). In this part, knowledge
+about Gaussian process or nonparametric models in general might be
+useful.
+
+For example, with the parameters we can select the kind of kernel,
+mean or surrogate model that we want to use. With the kernel we can
+play with the smoothness of the function and it's derivatives. The
+mean function can be use to model the overall trend (is it flat?
+linear?). If we know the overall signal variance we better use a
+Gaussian process, if we don't, we should use a Student's t process
+instead.

 For that reason, the parameters are bundled in a structure or
 dictionary, depending on the API that we use. This is a brief
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.