some improvements in methods description