Сейчас поясню по-хардкору :)

Берем любой стандарт rfc, например, xmpp(http://xmpp.org/rfcs/rfc6120.html) и смотрим на оформление. Что я предлагаю сделать на iinet.sexy:

* Объединить разделы API обмена и Технологии в один.
* Создать содержание с человекачитаемыми названиями.
Вместо названий, типа, GET /u/point/pauth/tmsg или POST /u/point обозвать это, как Отправка сообщений
* Простейший скрипт для push убрать в раздел примеры, или как-то так.
* Убрать раздел Стандарты, т.к. все это и есть стандарт.
* И.т.д. и.т.п. Надо ориентировать на оформление в стиле rfc

Короче, я могу поднять вики, где мы можем все сообща все это дело хорошо оформить, потом можно будет перенести это в хтмл/аскидок/и.т.д

Поднимать вики?

> Поднимать вики?
Думаю, лучше не надо. Если можешь что-то конкретно написать, напиши лучше сюда, так проще. Когда освобожусь, поменяю эти статьи