Document static linking and support OSX frameworks

Commits have the fun details, and scrutiny on the new documentation would be appreciated!