Resolve RD-5038

README.md

@@ -30,9 +30,7 @@ class MyApp extends React.Component {
     const request = { hostname: window.location.hostname, path: window.location.pathname + window.location.search };
     return (
       <CmsPage componentDefinitions={componentDefinitions} request={request}>
-        { () =>
-          <RenderCmsComponent />
-        }
+        <RenderCmsComponent />
       </CmsPage>
     )
   }
@@ -220,6 +218,42 @@ component to use for rendering the component. See the example below.
 <RenderCmsComponent path={'menu'} renderComponent={CmsMenu} />
 ```
 
+### Container components
+
+Container components are being used to hold container items, which will be rendered by the SDK. Whenever it needs to customize a layout of those container items, it is possible also to pass a custom container component in `componentDefinitions`.
+
+#### Example
+```jsx
+import React from 'react'
+import { CmsPage, RenderCmsComponent } from 'bloomreach-experience-react-sdk'
+
+function MyCustomFooter(props) {
+  return (
+    <footer>
+      <div class="logo">...</div>
+      { props.children }
+      <div class="copyright">...</div>
+    </footer>
+  );
+}
+
+const componentDefinitions = {
+  "Footer Container": { component: MyCustomFooter }
+}
+
+// ...
+
+class MyApp extends React.Component {
+  render() {
+    return (
+      <CmsPage componentDefinitions={componentDefinitions}>
+        <RenderCmsComponent />
+      </CmsPage>
+    )
+  }
+}
+```
+
 ### More component examples
 
 For more detailed examples, see the components included in the [example applications](https://github.com/bloomreach/experience-react-sdk/tree/master/examples/client-side-rendered/src/components). 
@@ -450,6 +484,13 @@ Parses date-field of a content item and returns date as a string.
 
 ## Release notes
 
+### Version 0.6.0
+- Added eslint.
+- Migrated to rollup.
+- Migrated to yarn.
+- Fixed CmsPage children to not be wrapped around a function.
+- Added support of custom React components for container components.
+
 ### Version 0.5.2
 - Fixed bug with query string affecting on the path parsing.
 
@@ -521,7 +562,8 @@ Upgrade steps:
 
 ## FAQ / Troubleshooting
 
-Nothing here yet :)
+- Information about common problems and possible solutions can be found on [the troubleshooting page](https://documentation.bloomreach.com/library/concepts/spa-plus/sdk/spa-sdk-troubleshooting.html).
+- Information about the recommended setup can be found on [the best practices page](https://documentation.bloomreach.com/library/concepts/spa-plus/sdk/spa-sdk-best-practices.html).
 
 ## License
 

examples/client-side-rendered/README.md

@@ -8,7 +8,8 @@ First, download and install the [BloomReach SPA demo project](https://github.com
 by following the instructions in the *Build Demo CMS project* section of the above link. Then run it by following the 
 instructions in *Run Demo CMS project*.
 
-Next, install the [UrlRewriter](https://documentation.bloomreach.com/library/enterprise/enterprise-features/url-rewriter/installation.html).
+Next, install the [UrlRewriter](https://documentation.bloomreach.com/library/enterprise/enterprise-features/url-rewriter/installation.html)
+and configure that according to [this document](https://documentation.bloomreach.com/library/concepts/spa-plus/url-rewriter-rules.html).
 
 Then, customize `.env` file to contain a correct [PUBLIC_URL](https://create-react-app.dev/docs/using-the-public-folder) path, for example:
 ```

examples/client-side-rendered/package.json

@@ -4,7 +4,7 @@
   "description": "Example client-side React App for the Bloomreach Experience SDK for React",
   "private": true,
   "dependencies": {
-    "bloomreach-experience-react-sdk": "^0.5.2",
+    "bloomreach-experience-react-sdk": "^0.6.0",
     "react": "^16.8.6",
     "react-dom": "^16.8.6",
     "react-router-dom": "^5.0.1",

examples/server-side-rendered/README.md

@@ -9,7 +9,8 @@ First, download and install the [BloomReach SPA demo project](https://github.com
 by following the instructions in the *Build Demo CMS project* section of the above link. Then run it by following the 
 instructions in *Run Demo CMS project*.
 
-Next, install the [UrlRewriter](https://documentation.bloomreach.com/library/enterprise/enterprise-features/url-rewriter/installation.html).
+Next, install the [UrlRewriter](https://documentation.bloomreach.com/library/enterprise/enterprise-features/url-rewriter/installation.html)
+and configure that according to [this document](https://documentation.bloomreach.com/library/concepts/spa-plus/url-rewriter-rules.html).
 
 Then, customize `.env` file to contain a correct PUBLIC_URL path, for example:
 ```

examples/server-side-rendered/package.json

@@ -4,7 +4,7 @@
   "description": "Example server-side React App for the Bloomreach Experience SDK for React",
   "private": true,
   "dependencies": {
-    "bloomreach-experience-react-sdk": "^0.5.2",
+    "bloomreach-experience-react-sdk": "^0.6.0",
     "dotenv": "^8.1.0",
     "isomorphic-unfetch": "^3.0.0",
     "next": "^9.0.2",

packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bloomreach-experience-react-sdk",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "Bloomreach Experience SDK for React",
   "keywords": [
     "bloomreach",