documentation for newly added method