@termonoid мне выглядит обычной, не лучше и не хуже других. Основная масса претензий, как мне выглядит, даже не к формату документации, а конкретно к activity stream с его "странностями" на первый взгляд, на другой вполне ок. Описывать достаточно абстрактные апи - тяжелая работа, логично что основная масса полей или даже все будут опшенал, логично что в многие филды прилетает OR что-то причем в совершенно любом виде т.к. HTTP+JSON особо не ограничивает в том что может прилететь. Тебе просто непривычно это, только и всего.
@s1o
> HTTP+JSON особо не ограничивает в том что может прилететь.
Для этого и существуют спецификации.
> не к формату документации
То есть написать человеческий тип вместо Object | Link не судьба было?