update to offerings class docs/diagram