[DOC] adding proper doc blocks