docs markup updated