[docs] update for nice markup