strapi · pwizla · Oct 5, 2022 · Apr 12, 2022 · Apr 12, 2022 · Apr 15, 2022
diff --git a/.algolia/docsearch.config.json b/.algolia/docsearch.config.json
@@ -1,34 +1,38 @@
 {
   "index_name": "documentation",
   "start_urls": [
-    "https://docs.strapi.io"
+    {
+      "url": "https://docs.strapi.io"
+    }
   ],
   "selectors": {
-    "lvl0": {
-      "selector": "(//*[contains(@class, 'sidebar-heading open')])[1]",
-      "type": "xpath",
-      "global": true
-    },
-    "lvl1": {
-      "selector": "//h1/text()",
-      "type": "xpath",
-      "global": true
-    },
-    "lvl2": {
-      "selector": "/html/head/meta[@name='description']/@content",
-      "type": "xpath",
-      "global": true
-    },
-    "lvl4": {
-      "selector": "//h2/text()",
-      "type": "xpath",
-      "global": true
-    },
-    "text": ".content__default p",
-    "lang": {
-      "selector": "/html/@lang",
-      "type": "xpath",
-      "global": true
+    "default": {
+      "lvl0": {
+        "selector": "(//*[contains(@class, 'sidebar-heading open')])[1]",
+        "type": "xpath",
+        "global": true
+      },
+      "lvl1": {
+        "selector": "//h1/text()",
+        "type": "xpath",
+        "global": true
+      },
+      "lvl2": {
+        "selector": "/html/head/meta[@name='description']/@content",
+        "type": "xpath",
+        "global": true
+      },
+      "lvl3": {
+        "selector": "//h2/text()",
+        "type": "xpath",
+        "global": true
+      },
+      "text": ".content__default p, .content__default ul>li a, .content__default ul>li code",
+      "lang": {
+        "selector": "/html/@lang",
+        "type": "xpath",
+        "global": true
+      }
     }
   },
   "strip_chars": " .,;:#",
@@ -40,4 +44,4 @@
       "lang"
     ]
   }
-}
+}
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -6,47 +6,44 @@ All efforts to contribute are highly appreciated, we recommend you talk to a mai
 
 ## Open Development & Community Driven
 
-Strapi is an open-source project. See the [LICENSE](https://github.com/strapi/documentation/blob/main/LICENSE) file for licensing information. All the work done is available on GitHub.
+Strapi is an open-source project. See the [LICENSE](https://github.com/strapi/documentation/blob/main/LICENSE) file for licensing information. All of the work is available on GitHub.
 
 The core team and the contributors send pull requests which go through the same validation process.
 
-## Documentation Requests
+## Code of Conduct
 
-Requests for new documentation are highly encouraged, this is not limited to new additions but also changes or more information requested on existing documentation. Please use our [request documentation](https://github.com/strapi/documentation/issues/new?template=DOC_REQUEST.md&title%5B%5D=REQUEST) issue template.
+This project and everyone participating in it are governed by the [Strapi Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold the code.
 
-## Code of Conduct
+## Documentation Requests
 
-This project and everyone participating in it are governed by the [Strapi Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. Please read the [full text](CODE_OF_CONDUCT.md) so that you can read which actions may or may not be tolerated.
+Requests for new documentation are highly encouraged, this is not limited to new additions but also changes or more information requested on existing documentation. Please use our [request documentation](https://github.com/strapi/documentation/issues/new?template=DOC_REQUEST.md&title%5B%5D=REQUEST) issue template. If you are requesting documentation, please feel free to open a pull request.
 
 ## Bugs
 
-We are using [GitHub Issues](https://github.com/strapi/documentation/issues) to manage our public bugs. Before submitting an issue you need to make sure:
+Bug reports help to improve the documentation. Please use our [Documentation Bug Report](https://github.com/strapi/documentation/issues/new?template=BUG_REPORT.yml) template to report documentation bugs. Before submitting an issue:
 
-- Checked for any existing pull requests that may address the same issue
-- Checked for any open issues related to your issue, if so, please provide context on that issue
-- Follow the issue template and try to fill out as much information as you can
-  - Issues not following the templates **will be closed**
-  - You may update the closed issue with the required information and it will be reopened
-- The issue is with the Strapi **documentation only**, code issues should be directed at the main [strapi/strapi](https://github.com/strapi/strapi) repo issues
-- If you are requesting documentation, please do feel free to make a pull request
-  - Documentation requests will be handled when we have free room within our roadmap
-  - Open requests **are not handled** in a "first come, first serve" basis, they are handled on a "best-effort" depending on the time required to produce
-- Do not ask technical questions about how to do something
-  - Questions should be directed at the following resources
-    - Open a Q&A thread on our [Official Forum](https://forum.strapi.io)
-    - Talk with other community members on our [Community Discord](https://discord.strapi.io)
+- Check for existing pull requests that may address the same issue.
+- Check for related open issues, if so, please provide context on the existing issue.
+- Follow the issue template and fill out as much information as you can.
+- Verify the issue is only with the Strapi documentation, code issues should be directed at the main [strapi/strapi](https://github.com/strapi/strapi) repository.
+
+Technical questions should be asked using the following resources:
 
-Please note that rude or impolite comments on issues that violate our [Code of Conduct](./CODE_OF_CONDUCT.md) will be deleted and issues that violate the COC will be closed.
+- Open a Q&A thread on our [Official Forum](https://forum.strapi.io)
+- Engage with other community members on our [Community Discord](https://discord.strapi.io)
 
 ---
 
-## Submitting a Pull Request
+## Pull Requests
 
-The core team will review your pull request and will either merge it, request changes to it, or close it.
+The core team reviews community pull requests and either merges, requests changes, or comments and closes the pull request. You can open a documentation pull request by:
 
-### Setup and pull request creation
+- clicking the `Improve this page` link at the bottom of any documentation page to directly edit in GitHub,
+- forking the `documentation` repository and working locally.
 
-Follow the procedure below to contribute to the Strapi documentation.
+### Setup and write locally
+
+The following procedure allows you to work locally on the Strapi documentation.
 
 1. Fork the `documentation` repository.
 2. Clone your forked `documentation` repository.
@@ -65,7 +62,7 @@ Follow the procedure below to contribute to the Strapi documentation.
     cd documentation/docs/user-docs
     ```
 
-4. Choose the branch from which to work: either `main` for a contribution on the latest, current version or Strapi ; or `v[x]` for a contribution on a previous version of Strapi.
+4. Choose the branch from which to work: either `main` for a contribution on the current version of Strapi or `v[x]` for a contribution on a previous version of Strapi.
 
     ```bash
     #current version of Strapi (i.e. v4)
@@ -86,7 +83,7 @@ Follow the procedure below to contribute to the Strapi documentation.
     git pull
     ```
 
-6. Create your own branch, based on either `main` or `v[x]` , on which you will work on your documentation contribution. Make sure the name of your branch indicates both the type of documentation and the topic.
+6. Create your branch, based on either `main` or `v[x]`, to work on your documentation contribution. Make sure your branch name indicates both the type of documentation and the topic.
 
     ```bash
     # developer documentation
@@ -118,43 +115,31 @@ Follow the procedure below to contribute to the Strapi documentation.
 
   The project is now up and running at http://localhost:8080 and you should be able to access it in your browser.
 
-
 You are now ready to contribute to the Strapi documentation! 🚀
 
-🤗 Make sure to follow the [12 Rules of Technical Writing](https://handbook.strapi.io/user-success-manual/12-rules-of-technical-writing) and the [Strapi Documentation Style Guide](https://handbook.strapi.io/user-success-manual/strapi-documentation-style-guide) when writing your documentation contribution. These documents are meant to help you write a contribution that fits the whole Strapi documentation and make the reviewing process easier and quicker.
-
-When you are finished writing, create a pull request from your forked repository to the original `documentation` repository (see [the GitHub docs](https://docs.github.com/en/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork) for more information).
+### Write technical documentation
 
-✋ To be able to submit your contribution, you must sign the CLA (Contributor License Agreement), directly via GitHub (see [our dedicated blog post](https://strapi.io/blog/switching-from-dco-to-cla) for more information).
+For lengthier contributions, we provide general guidelines that can help you write clear and concise documentation:
 
-### Pull request review and management
+- The [12 Rules of Technical Writing](https://handbook.strapi.io/user-success-manual/12-rules-of-technical-writing) gives an overview of how to structure and write clear documentation.
+- The [Strapi Documentation Style Guide](https://handbook.strapi.io/user-success-manual/strapi-documentation-style-guide) has formatting guidelines and how to implement formatting in markdown files.
 
-Read the information below to know how your contribution will be handled by the Strapi Documentation team until it is merged and deployed.
+When you are finished writing, create a pull request from your forked repository to the original `documentation` repository (see [the GitHub docs](https://docs.github.com/en/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork) for more information) or use the _Create a new branch for this commit and start a pull request_ option if you are using the GitHub web browser interface (see [the GitHub docs](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)).
 
-#### Handling
+✋ Sign the CLA (Contributor License Agreement), directly via GitHub (see [our dedicated blog post](https://strapi.io/blog/switching-from-dco-to-cla) for more information).
 
-When a new pull request is submitted in the Strapi `documentation` repository, it is handled in the following week, meaning that the Strapi team:
+### Review and management of pull requests
 
-- acknowledges the new pull request, leaving a 👀 reaction on the description
-- tags the pull request, to indicate the type of documentation that is being updated, and optionally the level of priority for the contribution
-- assigns the pull request to a member of the Strapi Documentation team, who will be in charge of the reviewing and merging
+The pull request review process and timeline are based on the availability of Strapi's Documentation team to handle community contributions. The workflow is:
 
-#### Review
+1. The pull request is assigned to a member of the Documentation team.
+2. At least 1 member of the Documentation team will review the pull request for:
 
-Once all of the handling steps are done by the Strapi team, you can expect your pull request to be reviewed in the next week or so.
+- accuracy,
+- quality,
+- alignment with the documentation scope and roadmap.
 
-Here is what the Strapi Documentation team will review in your pull request:
-
-- The accuracy and coherence of the contribution, by testing any new piece of code or action for example,
-- The quality of the technical writing, to make sure it is proper technical documentation that is easy to understand (see [12 Rules of Technical Writing](https://www.notion.so/12-Rules-of-Technical-Writing-c75e080e6b19432287b3dd61c2c9fa04))
-- The fit of the contribution among the rest of the Strapi documentation (see [Strapi Documentation Style Guide](https://www.notion.so/Strapi-Documentation-Style-Guide-b9c21387732741ed8b0a3f9701612577))
-
-The pull request will be validated once the contribution ticks all the boxes. At least the validation of the Strapi Documentation team member in charge of the pull request is necessary for it to be merged.
-
-#### Deployment
-
-Once your pull request is validated and merged, it will be deployed with the next batch of merged pull requests. The Strapi Documentation team only deploys the documentation on Wednesdays, but not every week.
+3. Reviewers will either approve, ask for changes, or reject the pull request.
+4. Accepted pull requests will be merged and deployed as part of the regular documentation deployments on Wednesdays every 2 weeks.
 
 Every documentation deployment is communicated through a message in [the "News" section of the Strapi forum](https://forum.strapi.io/c/news/5).
-
-
diff --git a/docs/.vuepress/config/theme-config.js b/docs/.vuepress/config/theme-config.js
@@ -1,5 +1,5 @@
 const themeConfig = {
-  logo: '/assets/logo.svg',
+  logo: '/assets/logo.png',
   nav: [
     {
       text: 'Resource Center',

diff --git a/docs/.vuepress/public/assets/SearchIcon.png b/docs/.vuepress/public/assets/SearchIcon.png
diff --git a/docs/.vuepress/styles/branding.styl b/docs/.vuepress/styles/branding.styl
@@ -1,4 +1,132 @@
 body
+// TODO: system fonts
+  font-family: system-ui
+
+.install-link
+  // text-decoration: none
+  background-color: #4945FF
+  border-radius: 6px
+  padding: 20px
+  color: $primary100
+  justify-content: space-between
+
+  .text
+    flex-grow: 1
+
+  .title
+    color: $neutral0
+
+  .description
+    color: $primary100
+
+  .arrow
+    width: 24px
+    height: 24px
+
+  &:hover
+    .title
+      color: $neutral0
+      text-decoration: underline
+    .description
+      color: $neutral0
+      // text-decoration: none
+    .arrow
+      // TODO:
+
+#algolia-autocomplete-listbox-0
+#algolia-autocomplete-listbox-1
+#algolia-autocomplete-listbox-2
+  left: 24px !important
+
+.search-box
+  display: inline-block
+  width: 20rem
+  margin: 0 !important
+  padding: 22px 0 20px 0 !important
+  text-align: center
+
+  >span
+    display: inline-block
+    width: 100%
+
+  .search-query
+    display: none
+
+  #algolia-search-input
+    display: inline-block
+    width: calc(20rem - 90px) !important
+    height: 40px !important;
+    padding: 0 0 0 40px !important;
+    font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif;
+    font-size: 13px !important;
+    color: $neutral600 !important
+    border-radius: 6px !important
+    border: 1px solid $neutral200 !important
+    background: #fff url(/assets/SearchIcon.png) 12px 12px no-repeat !important;
+    background-size: 16px 16px !important;
+
+    &::-webkit-input-placeholder
+       color $neutral600 !important
+    &:-moz-placeholder  /* Firefox 18- */
+       color $neutral600 !important
+    &::-moz-placeholder  /* Firefox 19+ */
+       color $neutral600 !important
+    &:-ms-input-placeholder
+       color $neutral600 !important
+
+.theme-container
+  display: flex
+  flex-direction: column
+  height: 100%
+
+.algolia-autocomplete
+  &.algolia-autocomplete-left
+    &.ds-dropdown-menu
+      left: 24px !important
+
+.al
+.algolia-search-wrapper
+  .algolia-autocomplete
+    .ds-dropdown-menu [class^=ds-dataset-]
+      padding: 0
+      border: 1px solid $neutral150
+      .ds-suggestions
+        margin-top: 0
+    .ds-dropdown-menu
+      overflow: initial
+      margin: 10px 0 0
+      box-shadow 0 1px 3px 1px rgba(0,0,0,.15)
+      &:before
+        background $neutral100
+        border: 1px solid $neutral150
+        box-shadow 0 1px 3px 1px $neutral150
+      .ds-suggestion.ds-cursor
+        .algolia-docsearch-suggestion:not(.suggestion-layout-simple)
+          .algolia-docsearch-suggestion--content
+            background-color: $primary100
+    .algolia-docsearch-suggestion
+      padding: 0
+      .algolia-docsearch-suggestion--wrapper
+        padding: 0 0 0 16px
+      .algolia-docsearch-suggestion--category-header
+        margin: 0
+        padding: 10px 16px 10px
+        color: $neutral900 !important
+        border-bottom: 1px solid $neutral150 !important
+        background: $neutral100
+      .algolia-docsearch-suggestion--subcategory-column
+        color: $neutral600 !important
+        &:before
+          background $neutral150
+      .algolia-docsearch-suggestion--title
+        padding-right: 16px
+        color $neutral900 !important
+        line-height 22px !important
+      .algolia-docsearch-suggestion--text
+        padding-right: 16px
+        color $neutral400 !important
+    .algolia-docsearch-footer
+      display: none !important
   font-family system-ui
   color $neutral800