Updated Documentation Structure and Added More details.

Vinod Kumar · Vinod Kumar · commit fc94e46fb146 · 2022-05-29T00:32:38.000+05:30
Added Logo
diff --git a/docs/adoption.md b/docs/adoption.md
@@ -0,0 +1,5 @@
+---
+id: adoption
+title: Adoption guide
+---
+
diff --git a/docs/contribution.md b/docs/contribution.md
@@ -0,0 +1,5 @@
+---
+id: contribution
+title: Contribution guide
+---
+
diff --git a/docs/features.md b/docs/features.md
@@ -0,0 +1,24 @@
+---
+id: features
+title: Capability Summary 
+---
+
+## Ecosystem of this reference architecture generator  🎉
+
+- **Scalable Architecture:** Generate SSG, SSR and Micro-App.
+- **Development Environment:** Monorepo setup along with Storybook integrated for developing and showcasing components.
+- **Micro Frontend:** Develop Micro Frontend architecture with Module Federation.
+- **Static Code Quality checks and formatting:** Javascript and CSS linting using Eslint, StyleLint and Prettier.
+- **Component scaffolding:** Consistently generate components, services and pages using [Generate-Plop](https://github.com/pagesource/component-generator).
+- **Git Hooks:** Pre-commit, Pre-push using Husky.
+- **Testing:** Unit testing with Jest, RTL and Test Cafe for E2E.
+- **Theme and Styling:** with Styled Components.
+- **Next.js:** To develop SSR and SSG with great ease.
+- **PWA:** Develop offline apps or just performant.
+- **Authoring:** Made easy with Markdown-to-JSX.
+- **Mocking:** Mock REST and GraphQl APIs.
+- **Localization:** Switch content based on language preference.
+- **State Management:** Lightest state management with Context APi and [Smart-Context](https://www.npmjs.com/package/smart-context).
+- **Data Fetching:** Change the old way of Data Fetching with [React Query](https://react-query.tanstack.com/).
+- **Type Safe:** TypeScript by Default.
+
diff --git a/docs/how.md b/docs/how.md
@@ -0,0 +1,6 @@
+---
+id: how
+title: How this generator works? 
+sidebar_label: How Universal React works? 
+---
+
diff --git a/docs/intro.md b/docs/intro.md
@@ -1,46 +1,16 @@
 ---
 id: intro
-title: Getting Started
-sidebar_label: Getting Started
+title: Universal React
 ---
-[![Forks](https://img.shields.io/github/forks/pagesource/universal-react-v2)](https://img.shields.io/github/forks/pagesource/universal-react-v2) [![Stars](https://img.shields.io/github/stars/pagesource/universal-react-v2)](https://img.shields.io/github/stars/pagesource/universal-react-v2) [![License](https://img.shields.io/github/license/pagesource/universal-react-v2)](https://img.shields.io/github/license/pagesource/universal-react-v2)
 
-# Universal React
+[![Forks](https://img.shields.io/github/forks/pagesource/universal-react-v2)](https://img.shields.io/github/forks/pagesource/universal-react-v2) [![Stars](https://img.shields.io/github/stars/pagesource/universal-react-v2)](https://img.shields.io/github/stars/pagesource/universal-react-v2) [![License](https://img.shields.io/github/license/pagesource/universal-react-v2)](https://img.shields.io/github/license/pagesource/universal-react-v2)
 
 An accelerator for setting-up scalable frontend architecture with Next.js and React.
 
 This accelerator is a command line tool for generating SSR, SSG & Micro-App type of applications. This enables you to setup a working Micro Frontend or SPA development ecosystem with essential tooling for great dev experience and delivery quality.
 
 This will help project teams in building applications with great quality, by giving them more time to focus on business problems rather than web development chores.
 
-## Ecosystem of this reference architecture generator  🎉
-
-- **Scalable Architecture:** Generate SSG, SSR and Micro-App.
-- **Development Environment:** Monorepo setup along with Storybook integrated for developing and showcasing components.
-- **Micro Frontend:** Develop Micro Frontend architecture with Module Federation.
-- **Static Code Quality checks and formatting:** Javascript and CSS linting using Eslint, StyleLint and Prettier.
-- **Component scaffolding:** Consistently generate components, services and pages using [Generate-Plop](https://github.com/pagesource/component-generator).
-- **Git Hooks:** Pre-commit, Pre-push using Husky.
-- **Testing:** Unit testing with Jest, RTL and Test Cafe for E2E.
-- **Theme and Styling:** with Styled Components.
-- **Next.js:** To develop SSR and SSG with great ease.
-- **PWA:** Develop offline apps or just performant.
-- **Authoring:** Made easy with Markdown-to-JSX.
-- **Mocking:** Mock REST and GraphQl APIs.
-- **Localization:** Switch content based on language preference.
-- **State Management:** Lightest state management with Context APi and [Smart-Context](https://www.npmjs.com/package/smart-context).
-- **Data Fetching:** Change the old way of Data Fetching with [React Query](https://react-query.tanstack.com/).
-- **Type Safe:** TypeScript by Default.
-
-
-## Main Technology Dependencies
-
-1. React
-2. Next.js
-3. Turborepo
-4. Node.js
-4. Python
-
 ## Uses
 
 ```sh
@@ -51,12 +21,19 @@ This will run the universal-react CLI, then you can simply interact with command
 
 [![CLI Generator Features by Rakesh Kumar 10](https://s7.gifyu.com/images/Banner018d3b1cbb27ffe53f.jpg)](https://web.microsoftstream.com/video/3b7ca6eb-d0ac-47e9-819b-d3e5e398ba09 "CLI Generator Features by Rakesh Kumar 10")
 
-### Pre Requisites
+## Main Tech Dependencies
+
+1. React
+2. Next.js
+3. Turborepo
+
+### Uses Prerequisites
 1. Node >= 14.17.6
 2. NPM >= 7.0.0
 3. Python Latest Version
 
-### Contributors
+
+## Contributors
 
 This project exists thanks to all the people who contribute.
 <a href="https://github.com/pagesource/universal-react-v2/graphs/contributors"><img src="https://opencollective.com/universal-react-v2/contributors.svg?width=890&button=false" /></a>
diff --git a/docs/quality-control.md b/docs/quality-control.md
@@ -1,6 +1,6 @@
 ---
-id: qualiy-control
-title: qualiy-control
+id: quality-control
+title: Static Quality Control
 sidebar_label: Quality Control
 ---
 
diff --git a/docs/road-map.md b/docs/road-map.md
@@ -0,0 +1,5 @@
+---
+id: road-map
+title: Future road map
+---
+
diff --git a/docs/support.md b/docs/support.md
@@ -0,0 +1,6 @@
+---
+id: support
+title: Support Options
+sidebar_label: Support 
+---
+
diff --git a/docs/what.md b/docs/what.md
@@ -0,0 +1,6 @@
+---
+id: what
+title: What this generator can achieve?
+---
+
+
diff --git a/docs/why.md b/docs/why.md
@@ -0,0 +1,21 @@
+---
+id: why
+title: Why we need this generator? 
+---
+
+## Pain Points of Frontend Development!
+
+1. **Reinventing the wheel** when setting up new projects. 
+2. Maturity and quality of the solution depends on the architect on the project.
+3. Delays setting up dev eco-systems, quality gates and pipelines.
+4. Overall lack of efficiency, as replication of best practices isn’t easy. 
+
+## How does Universal React addresses above concerns? 
+
+1. Enterprise scale React applications needs a lot more focused solutions. 
+2. Continuous value addition beyond initial setup through accelerators.
+3. Developer experience needs utmost attention for great productivity.
+4. Preservation and replication of low-level best practices is a necessity in era of green teams. 
+
+With **Reuse, Replicate and Reduce**  philosophy at its core Universal React is an accelerator to generate SSR, SSG or Micro-Apps with essential tooling to enable great dev experience and solution quality.
+
diff --git a/docusaurus.config.js b/docusaurus.config.js
@@ -1,5 +1,5 @@
 module.exports = {
-  title: 'Universal React Docs',
+  title: 'Universal React',
   tagline:
     'An accelerator for great developer experience.',
   url: 'https://github.com/',
@@ -31,18 +31,7 @@ module.exports = {
     },
     footer: {
       style: 'light',
-      links: [
-        {
-          title: 'Docs',
-          items: [
-            {
-              label: 'Getting Started',
-              to: 'docs/intro',
-            },
-          ],
-        },
-      ],
-      copyright: `Copyright © ${new Date().getFullYear()} Universal React`,
+      copyright: `Copyright © ${new Date().getFullYear()}, Made with ♥ by XE Community of Publicis Sapient. <br />Documentation site built with <a href="https://docusaurus.io/">Docusaurus<a/>.`,
     },
   },
   presets: [
diff --git a/sidebars.js b/sidebars.js
@@ -1,6 +1,6 @@
 module.exports = {
   someSidebar: {
-    Introduction: ['intro' ],
-    Features: ['qualiy-control','smart-context','unit-testing','design-system','loader','web-component','logger', 'generate-plop', 'module-federation'],
+    Introduction: ['intro', 'why', 'what', 'how', 'road-map', 'contribution', 'adoption', 'support'],
+    Features: ['features', 'quality-control', 'smart-context', 'unit-testing', 'design-system', 'loader', 'web-component', 'logger', 'generate-plop', 'module-federation', 'monorepo', 'storybook'],
   },
 };
diff --git a/src/css/custom.css b/src/css/custom.css
@@ -22,4 +22,4 @@
   display: block;
   margin: 0 calc(-1 * var(--ifm-pre-padding));
   padding: 0 var(--ifm-pre-padding);
-}
+}
diff --git a/src/pages/index.js b/src/pages/index.js
@@ -12,16 +12,16 @@ const features = [
     imageUrl: 'img/undraw_docusaurus_mountain.svg',
     description: (
       <>
-        This accelerator is a command line tool for generating SSR, SSG & Micro-App type of applications. This enables you to setup a working Micro Frontend or SPA development ecosystem with essential tooling for great dev experience and delivery quality.
+        CLI tool for generating SSR, SSG & Micro-App type of applications. 
       </>
     ),
   },
   {
-    title: <>Focus on What Matters</>,
+    title: <>Focus on What Matters!</>,
     imageUrl: 'img/undraw_docusaurus_tree.svg',
     description: (
       <>
-        Lets you focus on business problems rather than web development chores by addressing Architecture, Tooling, Code Quality, Scaffolding, Testing, Best Practices and most importantly Developer experience. 
+        Lets you focus on business problems rather than web development chores. 
       </>
     ),
   },
@@ -30,7 +30,7 @@ const features = [
     imageUrl: 'img/undraw_docusaurus_react.svg',
     description: (
       <>
-        Run <strong>npx create-universal-react</strong> This will run the create-universal-react CLI, then you can simply interact with command-prompt to generate 3 different kind of applications in a Monorepo structure.
+        Run <strong>npx create-universal-react</strong> This will run the create-universal-react CLI.
       </>
     ),
   },
@@ -45,8 +45,8 @@ function Feature({ imageUrl, title, description }) {
           <img className={styles.featureImage} src={imgUrl} alt={title} />
         </div>
       )}
-      <h3>{title}</h3>
-      <p>{description}</p>
+      <h3 className="text--center">{title}</h3>
+      <p className="text--center">{description}</p>
     </div>
   );
 }
diff --git a/static/img/UniversalReact.svg b/static/img/UniversalReact.svg
@@ -0,0 +1,39 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="1000" height="1000" viewBox="0 0 1000 1000" xml:space="preserve">
+<desc>Created with Fabric.js 3.5.0</desc>
+<defs>
+</defs>
+<rect x="0" y="0" width="100%" height="100%" fill="#ffffff"/>
+<g transform="matrix(1 0 0 1 499.8196 497.6551)" id="595064">
+<g style="">
+		<g transform="matrix(1.9482 0 0 1.9482 0.0018 0.0018)" id="971303">
+<g style="" vector-effect="non-scaling-stroke">
+		<g transform="matrix(1 0 0 1 0.0341 126.9664)" id="Layer_1">
+<path style="stroke: none; stroke-width: 1; stroke-dasharray: none; stroke-linecap: butt; stroke-dashoffset: 0; stroke-linejoin: miter; stroke-miterlimit: 4; is-custom-font: none; font-file-url: none; fill: rgb(0,0,0); fill-rule: nonzero; opacity: 1;" transform=" translate(-256.034, -382.9664)" d="M 434.72 445.25 l -31.13 -44.18 a 90.28 90.28 0 0 0 -34.4 -28.51 l -61.72 -29.19 a 127.65 127.65 0 0 0 -73 -10.94 l -69.07 10 a 20.21 20.21 0 0 0 -4.4 1.16 L 108 315.4 a 21.49 21.49 0 0 0 -23.54 35.73 l 83.75 67.13 A 116.2 116.2 0 0 0 253 443.37 l 69.18 -6.91 l 12.51 14.83 a 4.94 4.94 0 0 0 7.55 -6.38 L 328 428.1 a 4.86 4.86 0 0 0 -4.26 -1.73 L 252 433.54 a 106.41 106.41 0 0 1 -77.61 -23 L 90.61 343.41 a 11.62 11.62 0 0 1 -1.13 -17.07 a 11.67 11.67 0 0 1 13.86 -2.22 l 48.86 26 a 20.45 20.45 0 0 0 12.53 32.75 l 108.83 14.2 a 4.95 4.95 0 1 0 1.29 -9.81 L 166.32 373.14 a 10.59 10.59 0 0 1 -3.47 -19.46 a 4.62 4.62 0 0 0 0.81 -0.45 a 10.51 10.51 0 0 1 3.15 -1 l 69.06 -10 a 117.45 117.45 0 0 1 67.38 10.09 L 365 381.49 a 80.39 80.39 0 0 1 30.58 25.33 l 31.08 44.12 a 5 5 0 0 0 4.05 2.1 a 4.88 4.88 0 0 0 2.84 -0.9 A 4.94 4.94 0 0 0 434.72 445.25 Z" stroke-linecap="round"/>
+</g>
+		<g transform="matrix(1 0 0 1 -0.0095 -126.9432)" id="Layer_1">
+<path style="stroke: none; stroke-width: 1; stroke-dasharray: none; stroke-linecap: butt; stroke-dashoffset: 0; stroke-linejoin: miter; stroke-miterlimit: 4; is-custom-font: none; font-file-url: none; fill: rgb(0,0,0); fill-rule: nonzero; opacity: 1;" transform=" translate(-255.9905, -129.0567)" d="M 108.4 110.93 a 90.36 90.36 0 0 0 34.41 28.51 l 61.72 29.19 a 127.34 127.34 0 0 0 54.55 12.28 a 128.93 128.93 0 0 0 18.47 -1.33 l 69.06 -10 a 20.21 20.21 0 0 0 4.4 -1.16 l 53 28.23 a 21.28 21.28 0 0 0 10.05 2.5 a 21.47 21.47 0 0 0 13.48 -38.23 L 343.82 93.75 A 116.14 116.14 0 0 0 259 68.63 l -69.17 6.92 l -12.5 -14.83 a 4.95 4.95 0 0 0 -7.57 6.37 L 184 83.91 a 4.8 4.8 0 0 0 4.27 1.73 L 260 78.46 a 106.49 106.49 0 0 1 77.62 23 l 83.74 67.14 a 11.59 11.59 0 0 1 1.15 17.06 a 11.67 11.67 0 0 1 -13.86 2.22 l -48.87 -26 a 20.46 20.46 0 0 0 -12.53 -32.76 l -108.82 -14.2 a 4.95 4.95 0 0 0 -1.29 9.81 l 108.53 14.15 a 10.59 10.59 0 0 1 3.51 19.43 a 5.43 5.43 0 0 0 -0.91 0.51 a 10.48 10.48 0 0 1 -3.09 0.95 l -69.07 10 a 117.69 117.69 0 0 1 -67.38 -10.09 L 147 130.51 a 80.51 80.51 0 0 1 -30.6 -25.33 L 85.37 61.06 a 4.94 4.94 0 1 0 -8.08 5.69 Z" stroke-linecap="round"/>
+</g>
+</g>
+</g>
+		<g transform="matrix(14.7908 0 0 14.7908 -6.6735 9.1996)" id="601685">
+<g style="" vector-effect="non-scaling-stroke">
+		<g transform="matrix(1 0 0 1 0 -0.755)">
+<circle style="stroke: none; stroke-width: 1; stroke-dasharray: none; stroke-linecap: butt; stroke-dashoffset: 0; stroke-linejoin: miter; stroke-miterlimit: 4; is-custom-font: none; font-file-url: none; fill: rgb(0,0,0); fill-rule: nonzero; opacity: 1;" cx="0" cy="0" r="1.785"/>
+</g>
+		<g transform="matrix(1 0 0 1 -0.0005 -0.759)">
+<path style="stroke: none; stroke-width: 1; stroke-dasharray: none; stroke-linecap: butt; stroke-dashoffset: 0; stroke-linejoin: miter; stroke-miterlimit: 4; is-custom-font: none; font-file-url: none; fill: rgb(0,0,0); fill-rule: nonzero; opacity: 1;" transform=" translate(-11.9995, -11.241)" d="m 7.002 14.794 l -0.395 -0.101 c -2.934 -0.741 -4.617 -2.001 -4.617 -3.452 c 0 -1.452 1.684 -2.711 4.617 -3.452 l 0.395 -0.1 l 0.111 0.391 a 19.507 19.507 0 0 0 1.136 2.983 l 0.085 0.178 l -0.085 0.178 c -0.46 0.963 -0.841 1.961 -1.136 2.985 l -0.111 0.39 z m -0.577 -6.095 c -2.229 0.628 -3.598 1.586 -3.598 2.542 c 0 0.954 1.368 1.913 3.598 2.54 c 0.273 -0.868 0.603 -1.717 0.985 -2.54 a 20.356 20.356 0 0 1 -0.985 -2.542 z m 10.572 6.095 l -0.11 -0.392 a 19.628 19.628 0 0 0 -1.137 -2.984 l -0.085 -0.177 l 0.085 -0.179 c 0.46 -0.961 0.839 -1.96 1.137 -2.984 l 0.11 -0.39 l 0.395 0.1 c 2.935 0.741 4.617 2 4.617 3.453 c 0 1.452 -1.683 2.711 -4.617 3.452 l -0.395 0.101 z m -0.41 -3.553 c 0.4 0.866 0.733 1.718 0.987 2.54 c 2.23 -0.627 3.599 -1.586 3.599 -2.54 c 0 -0.956 -1.368 -1.913 -3.599 -2.542 a 20.683 20.683 0 0 1 -0.987 2.542 z" stroke-linecap="round"/>
+</g>
+		<g transform="matrix(1 0 0 1 -0.0013 -0.7554)">
+<path style="stroke: none; stroke-width: 1; stroke-dasharray: none; stroke-linecap: butt; stroke-dashoffset: 0; stroke-linejoin: miter; stroke-miterlimit: 4; is-custom-font: none; font-file-url: none; fill: rgb(0,0,0); fill-rule: nonzero; opacity: 1;" transform=" translate(-11.9987, -11.2445)" d="m 6.419 8.695 l -0.11 -0.39 c -0.826 -2.908 -0.576 -4.991 0.687 -5.717 c 1.235 -0.715 3.222 0.13 5.303 2.265 l 0.284 0.292 l -0.284 0.291 a 19.718 19.718 0 0 0 -2.02 2.474 l -0.113 0.162 l -0.196 0.016 a 19.646 19.646 0 0 0 -3.157 0.509 l -0.394 0.098 z m 1.582 -5.529 c -0.224 0 -0.422 0.049 -0.589 0.145 c -0.828 0.477 -0.974 2.138 -0.404 4.38 c 0.891 -0.197 1.79 -0.338 2.696 -0.417 a 21.058 21.058 0 0 1 1.713 -2.123 c -1.303 -1.267 -2.533 -1.985 -3.416 -1.985 z m 7.997 16.984 c -1.188 0 -2.714 -0.896 -4.298 -2.522 l -0.283 -0.291 l 0.283 -0.29 a 19.827 19.827 0 0 0 2.021 -2.477 l 0.112 -0.16 l 0.194 -0.019 a 19.473 19.473 0 0 0 3.158 -0.507 l 0.395 -0.1 l 0.111 0.391 c 0.822 2.906 0.573 4.992 -0.688 5.718 a 1.978 1.978 0 0 1 -1.005 0.257 z m -3.415 -2.82 c 1.302 1.267 2.533 1.986 3.415 1.986 c 0.225 0 0.423 -0.05 0.589 -0.145 c 0.829 -0.478 0.976 -2.142 0.404 -4.384 c -0.89 0.198 -1.79 0.34 -2.698 0.419 a 20.526 20.526 0 0 1 -1.71 2.124 z" stroke-linecap="round"/>
+</g>
+		<g transform="matrix(1 0 0 1 -0.0006 -0.7552)">
+<path style="stroke: none; stroke-width: 1; stroke-dasharray: none; stroke-linecap: butt; stroke-dashoffset: 0; stroke-linejoin: miter; stroke-miterlimit: 4; is-custom-font: none; font-file-url: none; fill: rgb(0,0,0); fill-rule: nonzero; opacity: 1;" transform=" translate(-11.9994, -11.2448)" d="m 17.58 8.695 l -0.395 -0.099 a 19.477 19.477 0 0 0 -3.158 -0.509 l -0.194 -0.017 l -0.112 -0.162 A 19.551 19.551 0 0 0 11.7 5.434 l -0.283 -0.291 l 0.283 -0.29 c 2.08 -2.134 4.066 -2.979 5.303 -2.265 c 1.262 0.727 1.513 2.81 0.688 5.717 l -0.111 0.39 z m -3.287 -1.421 c 0.954 0.085 1.858 0.228 2.698 0.417 c 0.571 -2.242 0.425 -3.903 -0.404 -4.381 c -0.824 -0.477 -2.375 0.253 -4.004 1.841 c 0.616 0.67 1.188 1.378 1.71 2.123 z M 8.001 20.15 a 1.983 1.983 0 0 1 -1.005 -0.257 c -1.263 -0.726 -1.513 -2.811 -0.688 -5.718 l 0.108 -0.391 l 0.395 0.1 c 0.964 0.243 2.026 0.414 3.158 0.507 l 0.194 0.019 l 0.113 0.16 c 0.604 0.878 1.28 1.707 2.02 2.477 l 0.284 0.29 l -0.284 0.291 c -1.583 1.627 -3.109 2.522 -4.295 2.522 z m -0.993 -5.362 c -0.57 2.242 -0.424 3.906 0.404 4.384 c 0.825 0.47 2.371 -0.255 4.005 -1.842 a 21.17 21.17 0 0 1 -1.713 -2.123 a 20.692 20.692 0 0 1 -2.696 -0.419 z" stroke-linecap="round"/>
+</g>
+		<g transform="matrix(1 0 0 1 -0.001 -0.7594)">
+<path style="stroke: none; stroke-width: 1; stroke-dasharray: none; stroke-linecap: butt; stroke-dashoffset: 0; stroke-linejoin: miter; stroke-miterlimit: 4; is-custom-font: none; font-file-url: none; fill: rgb(0,0,0); fill-rule: nonzero; opacity: 1;" transform=" translate(-11.999, -11.2406)" d="M 12 15.313 c -0.687 0 -1.392 -0.029 -2.1 -0.088 l -0.196 -0.017 l -0.113 -0.162 a 25.697 25.697 0 0 1 -1.126 -1.769 a 26.028 26.028 0 0 1 -0.971 -1.859 l -0.084 -0.177 l 0.084 -0.179 c 0.299 -0.632 0.622 -1.252 0.971 -1.858 c 0.347 -0.596 0.726 -1.192 1.126 -1.77 l 0.113 -0.16 l 0.196 -0.018 a 25.148 25.148 0 0 1 4.198 0 l 0.194 0.019 l 0.113 0.16 a 25.136 25.136 0 0 1 2.1 3.628 l 0.083 0.179 l -0.083 0.177 a 24.742 24.742 0 0 1 -2.1 3.628 l -0.113 0.162 l -0.194 0.017 c -0.706 0.057 -1.412 0.087 -2.098 0.087 z m -1.834 -0.904 c 1.235 0.093 2.433 0.093 3.667 0 a 24.469 24.469 0 0 0 1.832 -3.168 a 23.916 23.916 0 0 0 -1.832 -3.168 a 23.877 23.877 0 0 0 -3.667 0 a 23.743 23.743 0 0 0 -1.832 3.168 a 24.82 24.82 0 0 0 1.832 3.168 z" stroke-linecap="round"/>
+</g>
+</g>
+</g>
+</g>
+</g>
+</svg>
diff --git a/static/img/logo.svg b/static/img/logo.svg

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +id: adoption
 +title: Adoption guide
 +---
++