add notes to solvers