core methods doc