rewrites a bit the documentation