As a developer working with Magnolia, I need to know which APIs are safe to use and which internal codebases are subject to change without notice.

Documentation should provide clear information to guide developers. We could create at least a Public API policy page, perhaps more (like the Deprecation policy page and the End-of-life policy page).

Michi has draft information here:

• https://wiki.magnolia-cms.com/display/DEV/Magnolia+APIs
• https://wiki.magnolia-cms.com/display/DEV/Concept+-+Open+Closed+Code+Space

Also see the presentation given by michi and sasha on 27/11/17 in the PD team meeting.