fix configuration docs and format the reference section better