more rework of docs