[docs] update formatting and add more details