Merge branch 'master' of ssh://github.com/laboro/dev into feature/BAP-21264_es8

Author: yshyshkin

api/authentication/index.rst

@@ -19,3 +19,11 @@ Out-of-the-box, OroPlatform provides the following authentication mechanism:
 
     Please note that WSSE authentication is deprecated and will be removed in one of the future LTS releases.
     Use :ref:`OAuth authentication<web-services-api--authentication--oauth>` instead.
+
+
+.. admonition:: Business Tip
+
+   Looking to make a digital commerce investment? Evaluate the |best B2B eCommerce platforms| on our comparison page.
+
+.. include:: /include/include-links-seo.rst
+   :start-after: begin

api/authentication/oauth-client-credentials.rst

@@ -72,3 +72,12 @@ An example of an API request:
     Authorization: Bearer your access token
 
 .. note:: Access tokens for back-office and storefront API are not interchangeable. If you attempt to request data for the storefront API with a token generated for the back-office application, access will be denied.
+
+
+.. admonition:: Business Tip
+
+   |What is B2B eCommerce| and how does it differ from B2C? Read our guide to find out.
+
+
+.. include:: /include/include-links-seo.rst
+   :start-after: begin

api/authentication/oauth.rst

@@ -47,5 +47,13 @@ Generate Tokens
     to the storefront API resources is enabled automatically.
 
 
+.. admonition:: Business Tip
+
+    Want to take advantage of the new digital commerce trend? Check out everything you need to know about a |B2B wholesale marketplace|.
+
+
 .. include:: /include/include-links-dev.rst
    :start-after: begin
+
+.. include:: /include/include-links-seo.rst
+   :start-after: begin

api/enabling-api-feature.rst

@@ -14,5 +14,13 @@ on the :ref:`global <admin-configuration-application>` and :ref:`organization <a
 on the :ref:`global <admin-configuration-application>`, :ref:`organization <admin-configuration-application-org>`, and :ref:`website <admin-configuration-application-website>` levels.
 
 
+.. admonition:: Business Tip
+
+   Explore our guide on eCommerce to find out |B2B ecommerce meaning|, benefits, and examples.
+
+
 .. include:: /include/include-images.rst
    :start-after: begin
+
+.. include:: /include/include-links-seo.rst
+   :start-after: begin

api/http-methods.rst

@@ -63,6 +63,11 @@ Below is a table summarizing HTTP methods by its idempotency and safety:
 +-------------+------------+------+
 
 
+.. admonition:: Business Tip
+
+    Researching |B2B eCommerce platforms|? Explore our platform comparison guide to help you make an informed decision.
+
+
 .. _web-services-api--http-methods--get:
 
 GET
@@ -130,8 +135,13 @@ On successful deletion, the HTTP response status code 204 (No Content) returns w
     If you DELETE a resource, it is removed. Repeatedly calling DELETE on that resource will often return a 404 (NOT FOUND) status code since it was already removed and, therefore, is no longer findable.
 
 
+
+
 .. include:: /include/include-links-dev.rst
    :start-after: begin
 
 .. include:: /include/include-images.rst
    :start-after: begin
+
+.. include:: /include/include-links-seo.rst
+   :start-after: begin

api/index.rst

@@ -53,9 +53,21 @@ Find more information about Web API in the following topics:
 
 The documentation for the server-side developers can be found in :ref:`API Developer Guide <web-api>`.
 
+
+.. admonition:: Business Tip
+
+    Looking for the |open source B2B eCommerce platform| that can meet your business needs? Make sure to check our comprehensive platform comparison page.
+
+
+
+
+
 .. include:: /include/include-links-dev.rst
    :start-after: begin
 
+.. include:: /include/include-links-seo.rst
+   :start-after: begin
+
 .. toctree::
    :hidden:
 

backend/api/batch-api.rst

@@ -129,5 +129,14 @@ The following example shows how to reconfigure this adapter to use a local files
 You can find more examples in |KnpGaufretteBundle documentation|.
 
 
+
+.. admonition:: Business Tip
+
+   Explore our guide to learn how |digital transformation in manufacturing industry| improves operations, customer experiences, and sales.
+
+
 .. include:: /include/include-links-dev.rst
+   :start-after: begin
+
+.. include:: /include/include-links-seo.rst
    :start-after: begin

backend/api/how-to.rst

@@ -1299,5 +1299,14 @@ a new ``Acme\Bundle\DemoBundle\Entity\SomeEntity`` entity:
                 - { name: oro.api.processor, action: customize_form_data, event: post_submit, class: Acme\Bundle\DemoBundle\Entity\SomeEntity }
 
 
+.. admonition:: Business Tip
+
+   Do you want to get started with |digitalization in manufacturing|? Explore our guide for essential tips, best practices, and success stories.
+
+
+.. include:: /include/include-links-seo.rst
+   :start-after: begin
+
+
 .. include:: /include/include-links-dev.rst
     :start-after: begin

backend/architecture/bundle-less-structure.rst

@@ -6,24 +6,23 @@
 .. _dev-backend-architecture-bundle-less-structure:
 
 Bundle-less Structure
-======================
+=====================
 
-You can organize an OroPlatform based application code within :ref:`Symfony bundles <how-to-create-new-bundle>` or plain directories. Bundle-less directory structure support was added in OroPlatform v5.1 to follow the Symfony best practices and lower the entry level for new developers.
+You can organize an OroPlatform-based application code within :ref:`Symfony bundles <how-to-create-new-bundle>` or plain directories. Bundle-less directory structure support was added to OroPlatform v5.1 to follow the Symfony best practices and lower the entry level for new developers.
 This guide overviews the bundle-less structure and explains how to migrate the application code from the bundles-based to bundle-less structure.
 
-.. note:: The use of **bundle-less structure** is optional. However, for individual customization and expansion of Oro functionality or in other cases when creation a new bundle is impractical, a bundle-less structure can be used.
+.. note:: The use of **bundle-less structure** is optional. However, you can use a bundle-less structure for individual customization and expansion of Oro functionality or when creating a new bundle is impractical.
 
-The *bundle-less structure* includes the following (configuration and directory structure changes) application structure changes.
+The *bundle-less structure* includes the application structure changes outlined below (configuration and directory).
 
-Application-level structure Changes
+Application-level Structure Changes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. code-block:: none
 
-
     oro-application/
     ├── assets/
-    |   |── your-assets-dir                             # Here we can store our (scss, js, image, fonts) resources.
+    |   |── your-assets-dir                             # Here we can store the (scss, js, image, fonts) resources.
     |   └── ...
     ├── config/
     │   ├── batch_jobs                                  # Import and Export Configuration.
@@ -131,7 +130,7 @@ Application-level structure Changes
 Moving Existing Bundle to Bundle-less Structure
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-In order to port an existing bundle to a bundle-less structure, you must update the directory structure to the one shown above. There is no automatic tool for this update, so you must move your code following these guidelines:
+To port an existing bundle to a bundle-less structure, you must update the directory structure to the one shown above. There is no automatic tool for this update, so you must move your code following these guidelines:
 
 Migrations
 """"""""""
@@ -263,7 +262,7 @@ Workflows
 
     {BundleDir}/Resources/config/oro/workflows.yml -> config/oro/workflows/workflows.yml
 
-.. important:: All application-level workflows can be stored in separate directories, but must be registered in the /config/oro/workflows.yml file (via an import directive).
+.. important:: All application-level workflows can be stored in separate directories but must be registered in the /config/oro/workflows.yml file (via an import directive).
 
 
 Processes
@@ -376,7 +375,7 @@ System Configurations
 Extension and Configuration Moving
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-1. Create Extension and Configuration classes in ``/src/Configuration``
+1. Create Extension and Configuration classes in ``/src/Configuration``.
 
 .. code-block:: php
 
@@ -400,7 +399,7 @@ Extension and Configuration Moving
         }
     }
 
-2. Register the extension in ``AppKernel::build``
+2. Register the extension in ``AppKernel::build``.
 
 .. code-block:: php
 
@@ -415,19 +414,23 @@ Extension and Configuration Moving
 Themes & Layouts
 ~~~~~~~~~~~~~~~~
 
-1. Assets for themes should be moved to ``/src/assets/{your_theme_dir}/``
+1. Assets for themes should be moved to ``/src/assets/{your_theme_dir}/``.
 2. Admin theme configuration:
-    - ``/config/oro/assets.yml``
-    - ``/config/oro/jsmodules.yml``
-3. Storefront Themes and layouts should be placed in ``/templates/layouts/{your_theme_dir}/``
-    -  Themes configuration: ``/templates/layouts/{your_theme_dir}/theme.yml``
-    -  Layout assets configuration: ``/templates/layouts/{your_theme_dir}/config/assets.yml``
-    -  Layout theme configuration: ``/templates/layouts/{your_theme_dir}/config/config.yml``
+
+   - ``/config/oro/assets.yml``
+   - ``/config/oro/jsmodules.yml``
+
+3. Storefront Themes and layouts should be placed in ``/templates/layouts/{your_theme_dir}/``.
+
+   -  Themes configuration: ``/templates/layouts/{your_theme_dir}/theme.yml``
+   -  Layout assets configuration: ``/templates/layouts/{your_theme_dir}/config/assets.yml``
+   -  Layout theme configuration: ``/templates/layouts/{your_theme_dir}/config/config.yml``
 
 Tests
 ~~~~~
 
-1. Unit tests should be placed in ``/src/Test/Unit/``
-2. Functional tests should be placed in ``/src/Test/Functional/``
-3. Behat tests should be placed in ``/src/Test/Behat/``
-    - configuration for Behat services: ``/config/oro/behat_services.yml``
+1. Unit tests should be placed in ``/src/Test/Unit/``.
+2. Functional tests should be placed in ``/src/Test/Functional/``.
+3. Behat tests should be placed in ``/src/Test/Behat/``.
+
+   - Configuration for Behat services: ``/config/oro/behat_services.yml``

backend/architecture/custom-application.rst

@@ -7,32 +7,32 @@
 Custom Oro Application
 ======================
 
-No two businesses are alike. This motto is part of Oro products philosophy and this is why flexibility is one of
-the key principles that drive architecture in Oro. Depending on what you are planning to build, you can
+No two businesses are alike. This motto is part of Oro's product philosophy, which is why flexibility is one of
+the fundamental principles driving architecture. Depending on what you are planning to build, you can
 create your custom application with minimum functions starting either with |OroPlatform|, or |OroCRM|, or
 |OroCommerce| application as a baseline. No matter what is your starting point, there is no difference
 in the customization process.
 
 Application Repository and Installation
 ---------------------------------------
 
-Before you start working on a new project, it is important to have version control system in place.
+Before you start working on a new project, it is essential to have a version control system in place.
 The easiest way to start is to |fork application repository| of |OroPlatform|, |OroCRM| or |OroCommerce| on GitHub.
 
 Once code repository is ready, please follow :ref:`installation <installation>` instructions.
 
 .. note::
 
-    Newly created application repository should be used instead of the |https://github.com/orocrm/crm-application.git|
+    A newly created application repository should be used instead of the |https://github.com/orocrm/crm-application.git|
 
-When your application is up and running, you can use development mode to work on customizations. In order to warm up the 
-application cache in development mode please run:
+You can use development mode to work on customizations when your application is up and running. To warm up the
+application cache in development mode, please run:
 
 .. code-block:: none
 
         php bin/console cache:clear --env=dev
 
-To access application in development mode, add `index_dev.php` to the base URL
+To access the application in development mode, add `index_dev.php` to the base URL
 (example: ``http://orocrm.example.com/index_dev.php``).
 
 .. _application-custom-code:
@@ -41,46 +41,38 @@ Application Custom Code
 -----------------------
 
 Oro application structure is based on |Symfony Standard Edition| and we highly recommend to follow
-|Symfony Best Practices| for any custom application that you build on top of OroPlatform, OroCRM, or OroCommerce.
+|Symfony Best Practices| for any custom application you build on top of OroPlatform, OroCRM, or OroCommerce.
 
 In the root folder of your application, there is an `src` folder. Use it as a working directory
-for your custom project and put your custom code there. Like in Symfony applications, all custom code in Oro application
+for your custom project and put your custom code there. Like in Symfony applications, all custom code in the Oro application
 is organized in bundles - modules that group application functionality (see |Symfony Bundle System| for best practice
 of module structure and design).
 
 .. note::
-    Please note that Oro application has several :ref:`differences <book_differences>` compared to
+    Please note that the Oro application has several :ref:`differences <book_differences>` compared to
     Symfony Standard Edition.
 
-Typically, to create a custom application you may follow the common steps:
+Typically, to create a custom application you may follow the typical steps:
 
-#) :ref:`Create a bundle <how-to-create-new-bundle>`
-#) Introduce :ref:`new entity <dev-entities>` types that represent your business data structure and add
-   related features
-#) :ref:`Customize <architecture--customization--customize>` existing functionality
-   (:ref:`menu <doc-create-and-customize-app-menu>`, :ref:`workflow <dev-doc--workflows>`,
-   :ref:`extend entities <book-entities-extended-entities>` etc.)
+#) :ref:`Create a bundle <how-to-create-new-bundle>`.
+#) Introduce :ref:`new entity <dev-entities>` types that represent your business data structure and add related features.
+#) :ref:`Customize <architecture--customization--customize>` existing functionality (:ref:`menu <doc-create-and-customize-app-menu>`, :ref:`workflow <dev-doc--workflows>`, :ref:`extend entities <book-entities-extended-entities>`, etc.).
 
 Application Deployment
 ----------------------
 
-Oro applications are open source and may be deployed to the on-premise environments. Deployment method could be
-different depending on organization requirements and infrastructure. You can design your custom deployment process,
-noting the following recommendations:
+Oro applications are open source and can be deployed to on-premise environments. Deployment methods can vary depending on organization requirements and infrastructure. You can design your custom deployment process  but make sure you follow the recommendations below:
 
-#) Take into account recommendations in |Symfony Application Deployment| documentation
-#) Lock all dependencies with |composer.lock| before taking the code to production
-#) Warm up the application cache in production mode
-#) Disable access to `index_dev.php`
-#) Configure crontab and run web socket server
+#) Follow the advice outlined in the |Symfony Application Deployment| documentation.
+#) Lock all dependencies with |composer.lock| before taking the code to production.
+#) Warm up the application cache in production mode.
+#) Disable access to `index_dev.php`.
+#) Configure crontab and run web socket server.
 
 Oro applications are scalable.
 
 .. note::
-    As an alternative to the on-premise deployment, when you created your application following recommendations
-    :ref:`above <application-custom-code>`, you can put your application into |OroCloud|. Please contact us to
-    get more information.
-
+    As an alternative to the on-premise deployment, when you create your application following recommendations :ref:`above <application-custom-code>`, you can deploy your application to |OroCloud|. Please get in touch with us for more information.
 
 Related Articles
 ----------------