further mods to docs