doc: make new buffer construction methods more prominent
Make the new Buffer
construction methods more prominent in
the documentation and move the deprecated constructors to the
bottom of the page to reduce visibility and discourage use.
Checklist
-
make -j4 test
(UNIX), orvcbuild test
(Windows) passes -
documentation is changed or added -
commit message follows [commit guidelines]