Related with PR #991
- document and update guidelines to always us refactorable
::addTo() instead of ->add() when seed is not strictly an object
- migrate documentation (md and rst files)
- migrate commented code (php files)
To find the files to update use regex ->add\s*\((?!\$)