incorporated changes by Helene Gene
documentation reflects recent changes