updated list of card's description and added a small api flow description