Comment by andreygrehov

I would like to add Microsoft's API Guidelines [1] here, which is also a well written document and can be helpful to anyone designing an API.

[1]: https://github.com/Microsoft/api-guidelines/blob/master/Guid...