fixes confusing sections in the documentation