finishing doc and tweaking a visibility parameter