workaround for avoiding useless gem warning + updated readme with documentation