Improve offset documentation and add a note to implementors