added methods docs