documenting touch api