REST/CRUD. Я неправильно его готовлю? Часть 2

Замечательный гид по разработке API github.com/interagent/http-api-design. Все уже достаточно хорошо описано и используется в API heroku.

Автор, вам стоит поработать над стилем изложения информации: рвано, эмоционально, разрозненно, неожиданно заканчивается. Если на часах 3 ночи, то это не значит, что пора публиковать статью, это значит, что пора нажать кнопку «в черновики» и пойти спать, а утром, со свежей головой, еще раз прочитать/дописать/поправить.

Прочитав две статьи не понял почему их две? о_О Прочитав первую, я, еще как-то, понял вашу мысль, прочитав вторую не понял ничего — обрывки мыслей и информации про версионирование. Да и заголовок странноват…