api doc improvements