Сейчас поясню по-хардкору :)
Берем любой стандарт rfc, например, xmpp(
http://xmpp.org/rfcs/rfc6120.html) и смотрим на оформление. Что я предлагаю сделать на iinet.sexy:
* Объединить разделы API обмена и Технологии в один.
* Создать содержание с человекачитаемыми названиями.
Вместо названий, типа, GET /u/point/pauth/tmsg или POST /u/point обозвать это, как Отправка сообщений
* Простейший скрипт для push убрать в раздел примеры, или как-то так.
* Убрать раздел Стандарты, т.к. все это и есть стандарт.
* И.т.д. и.т.п. Надо ориентировать на оформление в стиле rfc
Короче, я могу поднять вики, где мы можем все сообща все это дело хорошо оформить, потом можно будет перенести это в хтмл/аскидок/и.т.д