updated JS document: part 1
some more