Update apiary.apib

Style correction for consistency "Organisations Collection". And some notes about the semi-implemented pagination concept.