Danil Klimov, это актуально, когда вы создаете посты с большим набором данных. В вашем случае не так важно, но лучше изначально писать код с расчетом на будущие фичи.
Отличие этой функции от wp_insert_post() в том, что здесь нет необходимости передавать все данные, можно указать только те, которые нужно обновить, остальные данные будут скопированы из уже имеющихся в базе данных.
RSalo, не, это был бы перебор. Расширяемость - одно из самых важных качеств, поэтому о нем будет написано на самом видном месте на сайте разрабов. Ну и документацию легче обновлять на сайте, чем распихивать по архивам.