Update doc on releases, incl explain internal 5.90 release version

README.md

@@ -8,6 +8,9 @@ eZ Publish 4 (Referred to as `legacy` in eZ Publish 5.x)
 
 What is eZ Publish?
 -------------------
+**eZ Publish is reaching end of life by 2021, current releases are primarily
+aimed at easing migration to it's successor; [eZ Platform](https://ezplatform.com/)**
+
 eZ Publish is a professional PHP application framework with advanced CMS
 (content management system) functionality. As a CMS its most notable feature
 is its fully customizable and extendable content model.
@@ -22,6 +25,19 @@ eZ Publish is database, platform and browser independent. Because it is
 browser based it can be used and updated from anywhere as long as you have
 access to the Internet.
 
+#### What is eZ Platform?
+
+eZ Publish's successor, eZ Platform, is a highly extensible, pure Content
+Managment Platform. It provides the same flexible content model at it's
+core like eZ Publish, and has a growing amount of additional features
+outside the traditional CMS scope provided by means of "Bundles"
+extending it.
+
+It is built on top of the full Symfony Framework, giving developers
+access to "standard" tools for rapid web & application development.
+
+Further reading on: https://ezplatform.com/
+
 
 License
 -------

doc/bc/5.90/README.md

@@ -0,0 +1,4 @@
+This folder contains backwards compatibility breaks to "5.90" releases, an alias for 2017.08 and higher releases.
+
+This release series is primarily to ease migration to [eZ Platform](https://ezplatform.com/), the sucessor to eZ Publish.
+

doc/changelogs/README.md

@@ -0,0 +1 @@
+For newer releases see changelogs found on [github releases](https://github.com/ezsystems/ezpublish-legacy/releases).

doc/features/5.90/README.md

@@ -0,0 +1,3 @@
+This folder contains features added to "5.90" release, an alias for 2017.08 and higher releases.
+
+For more new features, see [eZ Platform](https://ezplatform.com/), the sucessor to eZ Publish.

doc/features/5.90/event.md

@@ -11,7 +11,7 @@ make cache clearing logic between legacy and platform more solid for wider
 range of use cases.
 
     content/cache ( array $NodeIdist, array $objectIdList = null )
-    
+
 The new second argument is optional, however highly recommended
 to fill in if you have custom code emitting this event. Like before
 you are expected to return list of node ids _(same value or with