partial 2.5 updates for reference section