add notes -- partly -- js, ruby