added notes on experimental new replacement for addOrUpdateEntity()