Comment on the methods in FieldableEntity should document how they are meant ...