Problem Definition

The Confluence Editor has a feature to add comments when publishing a new version of an existing page.
This feature is described in The Editor product documentation.

This feature is not available when creating a new page, which would be important to record the reasoning of creating that page.
For example of a use case, when a page is migrated from another Wiki solution to Confluence, it would be interesting to add a version comment when the page is created (through the REST API in this use case).

Suggested Solution

Make the change comment feature available in the Confluence Editor when creating a new page.
Make it available on the REST API as well.

Workaround

When using the UI and the REST API:

1. Create a page with just a title and do not add any content.
2. Edit the same page with the actual content and add the version comment, treating the version 2 of the page as the version 1.