add helpers, adjust README