added docs & custom method