Improve the API doc description of the SmallArray primitive types

Say how it differs from Array in terms of size and performance.
These are primitives so it's also ok to talk a bit about implementation
details like card tables.