new doc & jUnit tests