docs: fix doc-comment typos and mismatches in public headers#15

smaheshwar-pltr wants to merge 2 commits into

mainsmaheshwar-pltr/iceberg-cpp:mainfrom

cleanup/header-doc-commentssmaheshwar-pltr/iceberg-cpp:cleanup/header-doc-commentsCopy head branch name to clipboard