added, updated and cleaned up documentation