documentation updates

Boost guide updated quite a bit, replaced allocate with construct.

see #22