a bit more of docs about the new approach