improve rest docs