Troubleshooting

.github/workflows/ci.yml

@@ -61,34 +61,6 @@ jobs:
 
       - run: bundle exec rake check_ca
 
-  link_validation_check_scos_dev:
-    name: Links validation (check_scos_dev)
-    needs: jekyll_build
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: 3.2.2
-          bundler-cache: true
-
-      - name: Cache HTMLProofer
-        id: cache-htmlproofer
-        uses: actions/cache@v2
-        with:
-          path: tmp/.htmlproofer
-          key: ${{ runner.os }}-check_scos_dev-htmlproofer
-
-      - uses: actions/download-artifact@v2
-
-      - name: Unpack artifacts
-        run: tar -xf build-result/result.tar.gz
-
-      - run: bundle exec rake check_scos_dev
-
   link_validation_check_scos_user:
     name: Links validation (check_scos_user)
     needs: jekyll_build

Rakefile

@@ -92,29 +92,6 @@ task :check_ca do
   HTMLProofer.check_directory("./_site", options).run
 end
 
-
-task :check_scos_dev do
-  options = commonOptions.dup
-  options[:ignore_files] = [
-    /docs\/ca\/.+/,
-    /docs\/fes\/.+/,
-    /docs\/acp\/.+/,
-    /docs\/dg\/.+/,
-    /docs\/scos\/user\/.+/,
-    /docs\/pbc\/.+/,
-    /docs\/scos\/\w+\/[\w-]+\/201811\.0\/.+/,
-    /docs\/scos\/\w+\/[\w-]+\/201903\.0\/.+/,
-    /docs\/scos\/\w+\/[\w-]+\/201907\.0\/.+/,
-    /docs\/scos\/\w+\/[\w-]+\/202001\.0\/.+/,
-    /docs\/scos\/\w+\/[\w-]+\/202005\.0\/.+/,
-    /docs\/scos\/\w+\/[\w-]+\/202009\.0\/.+/,
-    /docs\/scos\/\w+\/[\w-]+\/202108\.0\/.+/,
-    /docs\/scos\/\w+\/[\w-]+\/202204\.0\/.+/,
-    /docs\/scos\/\w+\/[\w-]+\/202400\.0\/.+/
-  ]
-  HTMLProofer.check_directory("./_site", options).run
-end
-
 task :check_scos_user do
   options = commonOptions.dup
   options[:ignore_files] = [

_config.yml

@@ -86,12 +86,6 @@ defaults:
       path: "docs/scos"
     values:
       product: "scos"
-  -
-    scope:
-      path: "docs/scos/dev"
-    values:
-      sidebar: "scos_dev_sidebar"
-      role: "dev"
   -
     scope:
       path: "docs/scos/user"
@@ -145,15 +139,6 @@ versions:
 
 # versioned categories - these must match corresponding directories
 versioned_categories:
-  scos:
-    dev:
-      - feature-integration-guides
-      - data-import
-      - data-export
-      - glue-api-guides
-      - the-docker-sdk
-      - system-requirements
-      - front-end-development
   dg:
     dev:
       - data-import
@@ -199,7 +184,6 @@ versioned_categories:
 sidebars:
   - ca_dev_sidebar
   - ca_devscu_sidebar
-  - scos_dev_sidebar
   - scos_user_sidebar
   - pbc_all_sidebar
   - dg_dev_sidebar

_data/sidebars/dg_dev_sidebar.yml

@@ -4,7 +4,7 @@ entries:
 - product: Development
   nested:
   - title: Developer getting started guide
-    url: /docs/scos/dev/developer-getting-started-guide.html
+    url: /docs/dg/dev/development-getting-started-guide.html
   - title: Set up locally
     url: /docs/dg/dev/set-up-spryker-locally/set-up-spryker-locally.html
     nested:
@@ -1259,6 +1259,103 @@ entries:
     - title: Coding best practices
       url: /docs/dg/dev/best-practices/coding-best-practices.html
 
+  - title: Troubleshooting
+    url: /docs/dg/dev/troubleshooting/troubleshooting.html
+    nested:
+    - title: Troubleshooting general technical issues
+      url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/troubleshooting-general-technical-issues.html
+      nested:
+      - title: Troubleshooting RabbitMQ
+        url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/troubleshooting-rabbitmq/troubleshooting-rabbitmq.html
+        nested:
+        - title: Messages are moved to error queues
+          url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/troubleshooting-rabbitmq/messages-are-moved-to-error-queues.html
+        - title: Messages are stuck in the Unacked state
+          url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/troubleshooting-rabbitmq/messages-are-stuck-in-the-unacked-state.html
+        - title: Messages are stuck without error notifications
+          url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/troubleshooting-rabbitmq/messages-are-stuck-without-error-notifications.html
+      - title: RabbitMQ - Zed.CRITICAL - PhpAmqpLib\Exception\AMQPChannelClosedException
+        url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/troubleshooting-rabbitmq/rabbitmq-zed.critical-phpamqplib-exception-amqpchannelclosedexception-channel-connection-is-closed.html
+      - title: Fail whale on the frontend
+        url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/fail-whale-on-the-frontend.html
+      - title: A command fails with a `Killed` message
+        url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/a-command-fails-with-a-killed-message.html
+      - title: 'API request fails with the exception: Session has not been set'
+        url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/api-request-fails-with-the-exception-session-has-not-been-set.html
+      - title: Composer version 2 compatibility issues
+        url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/composer-version-2-compatibility-issues.html
+      - title: Unable to resolve hosts for Mail, Jenkins, and RabbitMQ
+        url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/unable-to-resolve-hosts-for-mail-jenkins-and-rabbitmq.html
+      - title: PHPStan memory issues
+        url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/phpstan-memory-issues.html
+      - title: ProcessTimedOutException after queue-task-start
+        url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/processtimedoutexception-after-queue-task-start.html
+      - title: RuntimeException - Failed to execute regex - PREG_JIT_STACKLIMIT_ERROR
+        url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/runtimeexception-failed-to-execute-regex-preg-jit-stacklimit-error.html
+      - title: ERROR - remove spryker_logs - volume is in use
+        url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/error-remove-spryker-logs-volume-is-in-use.html
+      - title: Class Silex/ControllerProviderInterface not found
+        url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/class-silex-controllerproviderinterface-not-found.html
+      - title: Error response from daemon - OCI runtime create failed - .... \\\"no such file or directory\\\"\""- unknown
+        url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/error-response-from-daemon-oci-runtime-create-failed-no-such-file-or-directory-unknown.html
+
+      - title: Router generates absolute URL with localhost
+        url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/router-generates-absolute-url-with-localhost.html
+      - title: No data on the Storefront
+        url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/no-data-on-the-storefront.html
+      - title: The spy_oms_transition_log table takes up too much space
+        url: /docs/dg/dev/troubleshooting/troubleshooting-general-technical-issues/the-spy-oms-transition-log-table-takes-up-too-much-space.html
+    - title: Troubleshooting performance issues
+      url: /docs/dg/dev/troubleshooting/troubleshooting-performance-issues/troubleshooting-performance-issues.html
+      nested:
+      - title: External calls take a lot of time
+        url: /docs/dg/dev/troubleshooting/troubleshooting-performance-issues/external-calls-take-a-lot-of-time.html
+      - title: External calls—several calls to Zed
+        url: /docs/dg/dev/troubleshooting/troubleshooting-performance-issues/external-calls-several-calls-to-zed.html
+      - title: N+1 problem
+        url: /docs/dg/dev/troubleshooting/troubleshooting-performance-issues/n+1-problem.html
+      - title: Not optimized Composer on the production environment
+        url: /docs/dg/dev/troubleshooting/troubleshooting-performance-issues/not-optimised-composer-on-the-production-environment.html
+      - title: Redis session lock
+        url: /docs/dg/dev/troubleshooting/troubleshooting-performance-issues/redis-session-lock.html
+      - title: Slow Publish and Synchronization
+        url: /docs/dg/dev/troubleshooting/troubleshooting-performance-issues/slow-publish-and-synchronization.html
+      - title: Technology restrictions
+        url: /docs/dg/dev/troubleshooting/troubleshooting-performance-issues/technology-restrictions.html
+    - title: Troubleshooting Spryker in Docker issues
+      url: /docs/dg/dev/troubleshooting/troubleshooting-docker-issues/troubleshooting-docker-issues.html
+      nested:
+      - title: Troubleshooting debugging in Docker
+        nested:
+        - title: PHP `xdebug` extension is not active when accessing the website via
+            a browser or curl
+          url: /docs/dg/dev/troubleshooting/troubleshooting-docker-issues/troubleshooting-debugging-in-docker/php-xdebug-extension-is-not-active-when-accessing-the-website-via-a-browser-or-curl.html
+        - title: nc command tells that the port is opened
+          url: /docs/dg/dev/troubleshooting/troubleshooting-docker-issues/troubleshooting-debugging-in-docker/nc-command-tells-that-the-port-is-opened.html
+        - title: Xdebug does not work
+          url: /docs/dg/dev/troubleshooting/troubleshooting-docker-issues/troubleshooting-debugging-in-docker/xdebug-does-not-work.html
+        - title: nc command does not give any output
+          url: /docs/dg/dev/troubleshooting/troubleshooting-docker-issues/troubleshooting-debugging-in-docker/nc-command-does-not-give-any-output.html
+        - title: PHP `xdebug` extension is not active in CLI
+          url: /docs/dg/dev/troubleshooting/troubleshooting-docker-issues/troubleshooting-debugging-in-docker/php-xdebug-extension-is-not-active-in-cli.html
+      - title: Troubleshooting running applications in Docker
+        nested:
+        - title: An application is not reachable via http
+          url: /docs/dg/dev/troubleshooting/troubleshooting-docker-issues/troubleshooting-running-applications-in-docker/an-application-is-not-reachable-via-http.html
+        - title: Mutagen synchronization issue
+          url: /docs/dg/dev/troubleshooting/troubleshooting-docker-issues/troubleshooting-running-applications-in-docker/mutagen-synchronization-issue.html
+        - title: 413 Request Entity Too Large
+          url: /docs/dg/dev/troubleshooting/troubleshooting-docker-issues/troubleshooting-running-applications-in-docker/413-request-entity-too-large.html
+        - title: MacOS and Windows - file synchronization issues in Development mode
+          url: /docs/dg/dev/troubleshooting/troubleshooting-docker-issues/troubleshooting-running-applications-in-docker/macos-and-windows-file-synchronization-issues-in-development-mode.html
+        - title: Nginx welcome page
+          url: /docs/dg/dev/troubleshooting/troubleshooting-docker-issues/troubleshooting-running-applications-in-docker/nginx-welcome-page.html
+        - title: Mutagen error
+          url: /docs/dg/dev/troubleshooting/troubleshooting-docker-issues/troubleshooting-running-applications-in-docker/mutagen-error.html
+        - title: Port is already occupied on host
+          url: /docs/dg/dev/troubleshooting/troubleshooting-docker-issues/troubleshooting-running-applications-in-docker/port-is-already-occupied-on-host.html
+
+
 
   - title: Glue API
     url: /docs/dg/dev/glue-api/glue-api.html
@@ -1376,7 +1473,6 @@ entries:
           url: /docs/dg/dev/glue-api/glue-api-tutorials/validate-rest-request-format.html
 
 
-
   - title: Zed API
     url: /docs/dg/dev/zed-api/zed-api.html
     nested:
@@ -1431,3 +1527,10 @@ entries:
         url: /docs/dg/dev/miscellaneous-guides/using-database-transaction.html
       - title: "Transfer big databases between environments"
         url: /docs/dg/dev/miscellaneous-guides/transfer-big-databases-between-environments.html
+
+  - title: Code contribution guide
+    url: /docs/dg/dev/code-contribution-guide.html
+  - title: Code generator
+    url: /docs/dg/dev/code-generator.html
+  - title: Example modules
+    url: /docs/dg/dev/example-modules.html