[#2 state:resolved] write documentation