further clarifications, update curl examples
add ref to MS support article