docs: add methods, correct synopsis