minor update
document js methods