Создание API

[@DimICE]

Опечатка «Пока документировая»

[@qwertysx]

Исправил.

[@chernser]

А как вы решили проблему с версиями?

Кстати, для self правильнее было бы вернуть абсолютную ссылку (с айди) а не относительну (c me).

[@qwertysx]

Через headers. Автор ответил в комментариях к своему оригинальному посту. И благодаря презентерам, будет не сложно реализовать новые версии. Ведь это обычный руби класс, с наследованием и прочими фичами.

[@qwertysx]

А на счет /me. Дело в том, что нужно быть залогиненым. И /me доступно только вам. Пользователям не зачем знать не свои id. Хотя, конечно тут на свой вкус выбирайте.

[@VolCh]

Воспринимайте /me как алиас для /session, а не для /user/id

[@xappymah]

<irony>Люблю такие переводы. Они растят в людях желание учить английский и читать все в оригинале..</irony>

[@qwertysx]

Буду рад любой критики относительно перевода. Но чуть-чуть поконкретнее пожалуйста. Мой первый перевод. Да и если честно мне не просто искать свои же ошибки, к сожалению.

[@gribunin]

Если не принимать во внимание, что вы строите русские фразы по английским шаблонам, кроме этого много неточностей в переводе и отсебятины.

Оригинал: Despite building Gauges from the ground up as an API, it was a lot of work
Ваш перевод: Несмотря на уже существующий Gauges было не мало работы во время написания API
На самом деле: Несмотря на то, что Gauges с самого начала разрабатывался как API, потребовалось много работы.

Оригинал:: You really have to cross your t’s and dot your i’s when releasing an API.
Ваш перевод: Необходимо подробно разобраться с деталями.
На самом деле: Подготавливая API к релизу необходимо расставить все точки над «i».

Ваш перевод: Мы допустили ошибку, писав документацию
Слова «писав» нет в русском языке.
По-русски: Мы допустили ошибку, занявшись подготовкой документации

Вы: Оставляя эту рутину на потом, когда вы уже рады бы выпустить в свет API, делает работу вдвойне сложнее.
Кто делает?
По-русски: Откладывая эту рутину до того момента, когда вы были бы уже рады выпустить API, вы вдвойне усложняете её выполнение.

ну и т.п.

[@qwertysx]

Спасибо. Вроде бы и очевидно, а все равно допускаю такие ошибки.

[@xappymah]

Написал в личку.

[@qwertysx]

Спасибо. Все хорошо разложили по полочкам.

[@PapaBubaDiop]

Прямо сейчас Хорди Ромеро прочитал неплохой доклад по этой теме на тостере. Половина заключений доклада и статьи совпадают.

[@shifty]

Хочу поделиться довольно прогрессивной утилиткой по оптимизации и ускорению WP сайта.
WEBO Site SpeedUp для WordPress
Базовые функции — бесплатно, полный фарш — за деньги (можно потестить 14-й бесплатно).
(Так или иначе, все равно кому-то да приходится платить за скорость).

[@shifty]

сорри, не туда :(
сюда

[@night_amir]

По себе знаю — составлять документацию надо сразу. В сейчашнем проекте вообще сначала документацию написал, потом только реализовывал. Это позволило продумать часть проблем еще на этапе проектирования.

[@qwertysx]

Documentation Driven Development

[@night_amir]

What is Documenation Driven Development (DDD)?

DDD simply means that you write the documentation for things you plan to program before you actually start getting into the code. It is similiar to making an excact concept of your application but it more focused on the user then on the developer (of the project).

Именно так. Очень, ИМХО, правильный подход.