fix missing method + improve notes