JavaDoc & comments added to public APIs

Signed-off-by: yyenigun <yyenigun@gmail.com>