updated DESIGN with current API docs