updated introduction and documentation