We should add some documentation (sphinx) about optional flags (compilation, cmake)
to provide details about the consequences in installation of activating/deactivating those flags

e.g. --with-fortran=OFF ==> no event driven

• Where : Install guide?
• What : all options from CMake (see cmake/default_options.cmake)

I tend to think that beta1 and beta2 are off. I think that beta1=0.4 and beta2=0.1 may be better defaults than what we have right now, but this would need extensive testing. That's a very high gain but right now we rarely ever reject, and are usually 10-100x below the error estimate we are aiming for.

Summary
Add a new submodel for the particles which accounts for mechanical stress and stress assisted diffusion.

Additional context

1. First write a test that outlines how you would like the new submodel function. I think that loading the model so that you can run it will likely look something along the lines of:

options = {"Mechanics": True}
model = pybamm.DFN(options)

What to do with teo-post-install.md?

Seems like https://github.com/roboticslab-uc3m/teo-software-manual because it can require sim and cartesian, but do we want to limit it to TEO ?

Make low degree solvers work with complex numbers.
If they don't already.

I'd like to use your library, but the the code in this hub does not support the examples you give. Do you have an update to your code that has the IFunction interface and supporting classes?