DAPI-181 - improve the allocator big-theory a tad, to describe a bit what plugins expect as args and return as values.
DAPI-181 - improve the allocator big-theory a tad, to describe a bit what plugins
expect as args and return as values.

joyent/sdc-designation,joyent/sdc-designation