Why?

#65181 - Need documentation of REST API Requirements for Block Commenting Feature

Parent Issue: #66377 - Block Commenting iteration for WordPress 6.9
Implementation PR: #65181 - Add/rest api for block commenting
WordPress Version: 6.9 (originally developed for 6.7)
Feature Status: In development, requires WordPress 6.9 compatibility updates

Overview

This issue documents the comprehensive REST API requirements for the Block Commenting feature in WordPress 6.9. The Block Commenting feature allows users to add comments directly to individual blocks in the Gutenberg editor, creating a collaborative editing experience with threaded discussions.

Existing REST API Support

The current implementation includes basic REST API functionality:
Custom Comment Type: block_comment type for distinguishing block comments from regular comments
Basic CRUD Operations: Create, read, update, delete operations for block comments
Permission Handling: Basic permission checks for comment operations