update docs on configuration record & tidy up the layout a bit