improve doc

some random improvements and additions i stumbled over while updating our project.
all options are only set when not configured yet, as explained in the header of this chapter.