document and initial settings