Update JavaDoc + more samples with explaination