fix(readme & hint-event): write readme and handle case of undefined property in scope that does exsist