updated the recommendations, closed #546