add note about manual implementations and limitations