docs: add notes from past API review discussions
docs: add notes from past API review discussions

Swift SVN r26795

shahmishal/swift,JaSpa/swift,shajrawi/swift,swiftix/swift,johnno1962d/swift,tkremenek/swift,CodaFi/swift,CodaFi/swift,jtbandes/swift,gmilos/swift,arvedviehweger/swift,jckarter/swift,CodaFi/swift,JaSpa/swift,modocache/swift,jckarter/swift,harlanhaskins/swift,therealbnut/swift,tinysun212/swift-windows,alblue/swift,tardieu/swift,roambotics/swift,glessard/swift,KrishMunot/swift,adrfer/swift,ben-ng/swift,MukeshKumarS/Swift,practicalswift/swift,milseman/swift,amraboelela/swift,dduan/swift,kusl/swift,practicalswift/swift,bitjammer/swift,xwu/swift,jtbandes/swift,atrick/swift,milseman/swift,hooman/swift,gregomni/swift,gottesmm/swift,danielmartin/swift,benlangmuir/swift,ben-ng/swift,russbishop/swift,kperryua/swift,KrishMunot/swift,parkera/swift,devincoughlin/swift,milseman/swift,apple/swift,sschiau/swift,slavapestov/swift,gottesmm/swift,tinysun212/swift-windows,cbrentharris/swift,gmilos/swift,kusl/swift,ben-ng/swift,hughbe/swift,glessard/swift,tkremenek/swift,djwbrown/swift,sschiau/swift,roambotics/swift,bitjammer/swift,dduan/swift,parkera/swift,ben-ng/swift,manavgabhawala/swift,kstaring/swift,parkera/swift,austinzheng/swift,zisko/swift,adrfer/swift,gmilos/swift,karwa/swift,nathawes/swift,adrfer/swift,therealbnut/swift,ken0nek/swift,emilstahl/swift,zisko/swift,devincoughlin/swift,gmilos/swift,therealbnut/swift,kentya6/swift,frootloops/swift,gmilos/swift,return/swift,swiftix/swift.old,brentdax/swift,rudkx/swift,frootloops/swift,SwiftAndroid/swift,stephentyrone/swift,alblue/swift,aschwaighofer/swift,russbishop/swift,felix91gr/swift,gribozavr/swift,sschiau/swift,jtbandes/swift,nathawes/swift,LeoShimonaka/swift,hooman/swift,CodaFi/swift,danielmartin/swift,manavgabhawala/swift,IngmarStein/swift,gottesmm/swift,kstaring/swift,KrishMunot/swift,Ivacker/swift,tkremenek/swift,emilstahl/swift,IngmarStein/swift,adrfer/swift,jckarter/swift,swiftix/swift,jckarter/swift,hughbe/swift,slavapestov/swift,ahoppen/swift,bitjammer/swift,amraboelela/swift,aschwaighofer/swift,shajrawi/swift,uasys/swift,ken0nek/swift,dduan/swift,jmgc/swift,KrishMunot/swift,natecook1000/swift,khizkhiz/swift,swiftix/swift.old,tjw/swift,benlangmuir/swift,jmgc/swift,ahoppen/swift,calebd/swift,LeoShimonaka/swift,zisko/swift,felix91gr/swift,natecook1000/swift,kperryua/swift,CodaFi/swift,austinzheng/swift,johnno1962d/swift,slavapestov/swift,mightydeveloper/swift,Jnosh/swift,glessard/swift,cbrentharris/swift,JaSpa/swift,practicalswift/swift,Ivacker/swift,deyton/swift,russbishop/swift,danielmartin/swift,johnno1962d/swift,tardieu/swift,jopamer/swift,practicalswift/swift,gribozavr/swift,brentdax/swift,hughbe/swift,rudkx/swift,amraboelela/swift,rudkx/swift,tinysun212/swift-windows,felix91gr/swift,lorentey/swift,brentdax/swift,devincoughlin/swift,allevato/swift,tkremenek/swift,kentya6/swift,dduan/swift,mightydeveloper/swift,huonw/swift,allevato/swift,MukeshKumarS/Swift,practicalswift/swift,IngmarStein/swift,zisko/swift,sschiau/swift,swiftix/swift,codestergit/swift,manavgabhawala/swift,ken0nek/swift,kusl/swift,sschiau/swift,sdulal/swift,Ivacker/swift,jmgc/swift,jmgc/swift,lorentey/swift,JaSpa/swift,SwiftAndroid/swift,gottesmm/swift,kentya6/swift,danielmartin/swift,harlanhaskins/swift,roambotics/swift,russbishop/swift,dreamsxin/swift,OscarSwanros/swift,ahoppen/swift,calebd/swift,kusl/swift,gottesmm/swift,kusl/swift,swiftix/swift,shajrawi/swift,CodaFi/swift,gribozavr/swift,huonw/swift,xedin/swift,tinysun212/swift-windows,kentya6/swift,tinysun212/swift-windows,xwu/swift,CodaFi/swift,sschiau/swift,russbishop/swift,kperryua/swift,shahmishal/swift,uasys/swift,modocache/swift,gottesmm/swift,shajrawi/swift,airspeedswift/swift,atrick/swift,Ivacker/swift,practicalswift/swift,xedin/swift,codestergit/swift,milseman/swift,arvedviehweger/swift,jckarter/swift,MukeshKumarS/Swift,parkera/swift,jtbandes/swift,modocache/swift,arvedviehweger/swift,djwbrown/swift,swiftix/swift,jopamer/swift,tjw/swift,return/swift,cbrentharris/swift,OscarSwanros/swift,kentya6/swift,frootloops/swift,gribozavr/swift,modocache/swift,codestergit/swift,karwa/swift,kstaring/swift,JaSpa/swift,alblue/swift,gribozavr/swift,tjw/swift,jopamer/swift,manavgabhawala/swift,natecook1000/swift,modocache/swift,kstaring/swift,calebd/swift,brentdax/swift,modocache/swift,bitjammer/swift,zisko/swift,allevato/swift,SwiftAndroid/swift,xedin/swift,adrfer/swift,roambotics/swift,karwa/swift,JGiola/swift,hooman/swift,slavapestov/swift,austinzheng/swift,airspeedswift/swift,aschwaighofer/swift,xedin/swift,shajrawi/swift,huonw/swift,atrick/swift,amraboelela/swift,Jnosh/swift,codestergit/swift,return/swift,IngmarStein/swift,tjw/swift,xedin/swift,jopamer/swift,devincoughlin/swift,Jnosh/swift,austinzheng/swift,felix91gr/swift,karwa/swift,huonw/swift,tkremenek/swift,swiftix/swift,harlanhaskins/swift,emilstahl/swift,tinysun212/swift-windows,Ivacker/swift,slavapestov/swift,return/swift,harlanhaskins/swift,emilstahl/swift,JaSpa/swift,sdulal/swift,xedin/swift,ben-ng/swift,ken0nek/swift,therealbnut/swift,kperryua/swift,frootloops/swift,khizkhiz/swift,karwa/swift,deyton/swift,shahmishal/swift,tjw/swift,adrfer/swift,swiftix/swift.old,devincoughlin/swift,amraboelela/swift,apple/swift,austinzheng/swift,therealbnut/swift,swiftix/swift.old,therealbnut/swift,swiftix/swift,codestergit/swift,arvedviehweger/swift,hughbe/swift,benlangmuir/swift,airspeedswift/swift,mightydeveloper/swift,apple/swift,milseman/swift,jopamer/swift,OscarSwanros/swift,amraboelela/swift,jopamer/swift,allevato/swift,JGiola/swift,MukeshKumarS/Swift,xwu/swift,johnno1962d/swift,shajrawi/swift,natecook1000/swift,dduan/swift,mightydeveloper/swift,ahoppen/swift,kusl/swift,rudkx/swift,lorentey/swift,tardieu/swift,ben-ng/swift,djwbrown/swift,hughbe/swift,tardieu/swift,LeoShimonaka/swift,Ivacker/swift,cbrentharris/swift,Jnosh/swift,zisko/swift,tjw/swift,mightydeveloper/swift,uasys/swift,ken0nek/swift,parkera/swift,gribozavr/swift,hooman/swift,tkremenek/swift,hooman/swift,lorentey/swift,manavgabhawala/swift,ahoppen/swift,emilstahl/swift,kperryua/swift,danielmartin/swift,airspeedswift/swift,allevato/swift,IngmarStein/swift,felix91gr/swift,djwbrown/swift,harlanhaskins/swift,felix91gr/swift,djwbrown/swift,slavapestov/swift,parkera/swift,xedin/swift,shahmishal/swift,mightydeveloper/swift,JaSpa/swift,jmgc/swift,airspeedswift/swift,swiftix/swift.old,rudkx/swift,milseman/swift,devincoughlin/swift,rudkx/swift,swiftix/swift.old,milseman/swift,sschiau/swift,deyton/swift,deyton/swift,huonw/swift,allevato/swift,jtbandes/swift,danielmartin/swift,brentdax/swift,ahoppen/swift,slavapestov/swift,gmilos/swift,uasys/swift,swiftix/swift.old,kusl/swift,khizkhiz/swift,lorentey/swift,manavgabhawala/swift,codestergit/swift,khizkhiz/swift,felix91gr/swift,hooman/swift,harlanhaskins/swift,gregomni/swift,ben-ng/swift,hooman/swift,khizkhiz/swift,dduan/swift,uasys/swift,gribozavr/swift,shajrawi/swift,gregomni/swift,KrishMunot/swift,MukeshKumarS/Swift,MukeshKumarS/Swift,huonw/swift,parkera/swift,sdulal/swift,benlangmuir/swift,therealbnut/swift,xwu/swift,alblue/swift,gregomni/swift,dduan/swift,JGiola/swift,swiftix/swift.old,benlangmuir/swift,frootloops/swift,uasys/swift,Jnosh/swift,return/swift,LeoShimonaka/swift,arvedviehweger/swift,huonw/swift,apple/swift,cbrentharris/swift,practicalswift/swift,SwiftAndroid/swift,gmilos/swift,xwu/swift,roambotics/swift,xwu/swift,ken0nek/swift,airspeedswift/swift,manavgabhawala/swift,calebd/swift,Jnosh/swift,jtbandes/swift,benlangmuir/swift,aschwaighofer/swift,gribozavr/swift,cbrentharris/swift,alblue/swift,JGiola/swift,jckarter/swift,stephentyrone/swift,danielmartin/swift,austinzheng/swift,arvedviehweger/swift,deyton/swift,sdulal/swift,emilstahl/swift,roambotics/swift,JGiola/swift,cbrentharris/swift,natecook1000/swift,glessard/swift,LeoShimonaka/swift,JGiola/swift,aschwaighofer/swift,aschwaighofer/swift,airspeedswift/swift,calebd/swift,brentdax/swift,zisko/swift,kstaring/swift,ken0nek/swift,sdulal/swift,return/swift,sschiau/swift,mightydeveloper/swift,kperryua/swift,jmgc/swift,modocache/swift,karwa/swift,johnno1962d/swift,stephentyrone/swift,natecook1000/swift,cbrentharris/swift,practicalswift/swift,tjw/swift,alblue/swift,gregomni/swift,johnno1962d/swift,natecook1000/swift,hughbe/swift,arvedviehweger/swift,LeoShimonaka/swift,SwiftAndroid/swift,SwiftAndroid/swift,harlanhaskins/swift,xwu/swift,jckarter/swift,brentdax/swift,atrick/swift,nathawes/swift,allevato/swift,khizkhiz/swift,nathawes/swift,johnno1962d/swift,dreamsxin/swift,djwbrown/swift,OscarSwanros/swift,mightydeveloper/swift,kperryua/swift,russbishop/swift,shajrawi/swift,Ivacker/swift,shahmishal/swift,calebd/swift,OscarSwanros/swift,jmgc/swift,lorentey/swift,emilstahl/swift,tkremenek/swift,djwbrown/swift,karwa/swift,OscarSwanros/swift,return/swift,stephentyrone/swift,kstaring/swift,sdulal/swift,atrick/swift,calebd/swift,bitjammer/swift,alblue/swift,sdulal/swift,lorentey/swift,KrishMunot/swift,codestergit/swift,deyton/swift,IngmarStein/swift,glessard/swift,apple/swift,kusl/swift,stephentyrone/swift,shahmishal/swift,kentya6/swift,kentya6/swift,Ivacker/swift,xedin/swift,SwiftAndroid/swift,MukeshKumarS/Swift,emilstahl/swift,aschwaighofer/swift,austinzheng/swift,russbishop/swift,glessard/swift,jtbandes/swift,parkera/swift,khizkhiz/swift,adrfer/swift,devincoughlin/swift,nathawes/swift,jopamer/swift,frootloops/swift,LeoShimonaka/swift,shahmishal/swift,nathawes/swift,tardieu/swift,tinysun212/swift-windows,shahmishal/swift,OscarSwanros/swift,stephentyrone/swift,devincoughlin/swift,gottesmm/swift,sdulal/swift,KrishMunot/swift,Jnosh/swift,IngmarStein/swift,atrick/swift,tardieu/swift,nathawes/swift,kstaring/swift,frootloops/swift,lorentey/swift,gregomni/swift,uasys/swift,amraboelela/swift,deyton/swift,hughbe/swift,LeoShimonaka/swift,bitjammer/swift,karwa/swift,bitjammer/swift,tardieu/swift,apple/swift,stephentyrone/swift,kentya6/swift