# Discussion: django CMS v4 release plan

## Objective: Release in Q4/2022

Target audience:
* **django-cms experts starting new projects** at first

## Part of the release

* Django CMS v4 core
* djangocms-versioning
* djangocms-alias
* djangocms-text-ckeditor (preferrably **universal** package, target October)
* django-cms-quickstart
* djangocms-blog
* djangocms-versioning-filer (optional)

## Supporting packages
* djangocms-icon (tests available)
* djangocms-frontend (tests available)
* djangocms-picture (**tests for v4 to be created**)
* djangocms-attributes-field (**tests for v4 to be created**)
* djangocms-style (**tests for v4 to be created**)
* djangocms-link (**tests for v4 to be created**)
* djangocms-admin-style
* (django-filer)
* (django-classy-tags)
* *(Please add if necessary)*

## Third party packages *not* part of a release
* djangocms-url-manager
* djangocms_moderation
* djangocms_version_locking
* djangocms_pageadmin
* djangocms_navigation
* djangocms_references
* djangocms_fil_admin_style

## Roadblocks
* Documentation (what is the bare minimum to get going?)
* Last bugs in plugin tree ([#7391](https://github.com/django-cms/django-cms/issues/7391), [#7392](https://github.com/django-cms/django-cms/issues/7392), fixes available), page tree ([#7400](https://github.com/django-cms/django-cms/issues/7400), fix available), copy & paste pages ([djangocms-versioning#294](https://github.com/django-cms/djangocms-versioning/issues/294), no fix yet)
* `TitleExtension` rename to `PageContentExtension` ([#7369](https://github.com/django-cms/django-cms/pull/7369))
* Clarity on legacies (where to add deprecation warnings)
* Static placeholders not removed (despite being replaced by aliases)
* *(Please add if necessary)*
* *(Please add if necessary)*

## Accompanying measures

* **Process/governance for change management**
* testing in large-scale environments (where, who, what)?
* back-porting cms v3.x features/fixes missing in v4
* responding to issues and pr
* *(Please add if necessary)*
* Announcement of **key selling points**
* Under-the-hood improvements (lean, fast, scalable)
* Power of versioning and moderation for working in teams
* *(Please add if necessary)*
* **Blog entries/video tutorials** on
* How to install with quickstart and manually
* Setting up a simple project with Bootstrap 5 (using djangocms-frontend)
* How to adjust custom plugins to work **universally** with both CMS v3 and v4
* Migration v3 to v4 experiences (though that's not officially supported)
* Clear django-cms 4 **badge** on all v4 repositories and supporting packages
* *(Please add if necessary)*

## *After release:* Extending the ecosystem
* aldryn-apphook-config (alternatives?)
* django-app-helper
* djangocms-maps
* djangocms-history functionality
* djangocms-installer
* djangocms-page-meta
* djangocms-text-ckeditor5
* djangocms4-migration
* *(Please add if necessary)*