I have come to re-check some details in documentation and spotted the ideas at the top planned for AMS.

AMS is instrumental to our project, we use it heavily to keep sane view on serialization and keep the team producing clean code.

Some of the ideas are related to removing functionality that works perfectly currently therefore it is worry-some. I came to this PR to see background behind the decisions that I have not found. Is there other source where I can find rationals behind the decisions? Especially for removing that what works now?

DocumentSeriarlizer.new(UserSerializer.new(user)).as_json

This snippet looks backwards from what AMS does currently. However, perhaps it means that below will keep working? Can you please shed more light @bf4?

class Profile:UsersShowSerializer < ActiveModel::Serializer
  attributes ...
end

class User::UsersShowSerializer < ActiveModel::Serializer
  attribute :profile, :serializer => Profile::UsersShowSerializer
  ...
end

class UsersController < ApplicationController
  def show
    render json: user, status: :ok
  end
end