Adding some explanation on API differences
Adding some explanation on API differences

stephentoub/corefxlab,nguerrera/corefxlab,adamsitnik/corefxlab,stephentoub/corefxlab,alexperovich/corefxlab,whoisj/corefxlab,VSadov/corefxlab,Vedin/corefxlab,adamsitnik/corefxlab,tarekgh/corefxlab,hanblee/corefxlab,livarcocc/corefxlab,ericstj/corefxlab,dotnet/corefxlab,Vedin/corefxlab,stephentoub/corefxlab,Vedin/corefxlab,VSadov/corefxlab,VSadov/corefxlab,benaadams/corefxlab,whoisj/corefxlab,Vedin/corefxlab,tarekgh/corefxlab,benaadams/corefxlab,VSadov/corefxlab,ericstj/corefxlab,ericstj/corefxlab,ahsonkhan/corefxlab,VSadov/corefxlab,KrzysztofCwalina/corefxlab,ericstj/corefxlab,hanblee/corefxlab,Vedin/corefxlab,stephentoub/corefxlab,weshaggard/corefxlab,stephentoub/corefxlab,joshfree/corefxlab,ahsonkhan/corefxlab,VSadov/corefxlab,Vedin/corefxlab,joshfree/corefxlab,ericstj/corefxlab,KrzysztofCwalina/corefxlab,ericstj/corefxlab,dotnet/corefxlab,stephentoub/corefxlab,ravimeda/corefxlab