I find that MS are often quite good at developing good APIs and documenting them.

In this new doc I particularly like the Delta Queries section [0]. It's something that's difficult to get right but with this you can pretty much copy and paste their guidelines for your project.

0: https://github.com/Microsoft/api-guidelines/blob/master/Guid...