documentation : fixed various issues (see #219)