Abir docs updates

I'd put these as 2 bullets and add the definition of each