[DOCS] menu restructuring 2025 pass 3 mstr (#28719)

Moving configurations and troubleshooting articles to the installation section
openvinotoolkit · Jan 29, 2025 · 9a46c97 · 9a46c97
1 parent 80eee50
commit 9a46c97
Show file tree

Hide file tree

Showing 23 changed files with 29 additions and 31 deletions.
diff --git a/docs/articles_en/about-openvino/release-notes-openvino/system-requirements.rst b/docs/articles_en/about-openvino/release-notes-openvino/system-requirements.rst
@@ -93,13 +93,12 @@ Intel® Neural Processing Unit
 
    .. tab-item:: Additional considerations
 
-      * These Accelerators require :doc:`drivers <../../get-started/configurations/configurations-intel-npu>`
+      * These Accelerators require :doc:`drivers <../../get-started/install-openvino/configurations/configurations-intel-npu>`
         that are not included in the Intel® Distribution of OpenVINO™ toolkit package.
       * Users can access the NPU plugin through the OpenVINO archives on
         the :doc:`download page <../../get-started/install-openvino>`.
 
 
-
 Operating systems and developer environment
 #######################################################
 

diff --git a/docs/articles_en/get-started.rst b/docs/articles_en/get-started.rst
@@ -12,8 +12,6 @@ GET STARTED
    :hidden:
 
    Install OpenVINO <get-started/install-openvino>
-   Additional Hardware Setup <get-started/configurations>
-   Troubleshooting <get-started/troubleshooting-install-config>
    System Requirements <./about-openvino/release-notes-openvino/system-requirements>
 
 

diff --git a/docs/articles_en/get-started/install-openvino.rst b/docs/articles_en/get-started/install-openvino.rst
@@ -16,6 +16,7 @@ Install OpenVINO™ 2025.0
    OpenVINO Runtime on Windows <install-openvino/install-openvino-windows>
    OpenVINO Runtime on macOS <install-openvino/install-openvino-macos>
    Create an OpenVINO Yocto Image <install-openvino/install-openvino-yocto>
+   Additional Hardware Setup and Troubleshooting <install-openvino/configurations>
 
 .. raw:: html
 

diff --git a/...rticles_en/get-started/configurations.rst → ...arted/install-openvino/configurations.rst b/...rticles_en/get-started/configurations.rst → ...arted/install-openvino/configurations.rst
diff --git a/...nfigurations/configurations-intel-gpu.rst → ...nfigurations/configurations-intel-gpu.rst b/...nfigurations/configurations-intel-gpu.rst → ...nfigurations/configurations-intel-gpu.rst
@@ -91,13 +91,13 @@ To check if the driver has been installed:
 1. Type **device manager** in the **Search Windows** field and press Enter. **Device Manager** will open.
 2. Click the drop-down arrow to display **Display Adapters**. You can see the adapter that is installed in your computer:
 
-   .. image:: ../../assets/images/DeviceManager.PNG
+   .. image:: ../../../assets/images/DeviceManager.PNG
       :width: 400
 
 3. Right-click on the adapter name and select **Properties**.
 4. Click the **Driver** tab to view the driver version.
 
-   .. image:: ../../assets/images/DeviceDriverVersion.svg
+   .. image:: ../../../assets/images/DeviceDriverVersion.svg
       :width: 400
 
 Your device driver has been updated and is now ready to use your GPU.
@@ -132,8 +132,8 @@ Below are the required steps to make it work with OpenVINO:
 Additional Resources
 ####################
 
-* :doc:`GPU Device <../../openvino-workflow/running-inference/inference-devices-and-modes/gpu-device>`
-* :doc:`Install Intel® Distribution of OpenVINO™ toolkit from a Docker Image <../install-openvino/install-openvino-archive-linux>`
+* :doc:`GPU Device <../../../openvino-workflow/running-inference/inference-devices-and-modes/gpu-device>`
+* :doc:`Install Intel® Distribution of OpenVINO™ toolkit from a Docker Image <../install-openvino-archive-linux>`
 * `Docker CI framework for Intel® Distribution of OpenVINO™ toolkit <https://github.com/openvinotoolkit/docker_ci/blob/master/README.md>`__
 * `Get Started with DockerHub CI for Intel® Distribution of OpenVINO™ toolkit <https://github.com/openvinotoolkit/docker_ci/blob/master/get-started.md>`__
 * `Dockerfiles with Intel® Distribution of OpenVINO™ toolkit <https://github.com/openvinotoolkit/docker_ci/blob/master/dockerfiles/README.md>`__

diff --git a/...nfigurations/configurations-intel-npu.rst → ...nfigurations/configurations-intel-npu.rst b/...nfigurations/configurations-intel-npu.rst → ...nfigurations/configurations-intel-npu.rst
diff --git a/...ted/configurations/genai-dependencies.rst → ...ino/configurations/genai-dependencies.rst b/...ted/configurations/genai-dependencies.rst → ...ino/configurations/genai-dependencies.rst
@@ -24,8 +24,8 @@ as archives or python wheels), build OpenVINO GenAI library from
 Additional Resources
 #######################
 
-* :doc:`OpenVINO GenAI Installation Guide <../install-openvino/install-openvino-genai>`
+* :doc:`OpenVINO GenAI Installation Guide <../install-openvino-genai>`
 * `OpenVINO GenAI repository <https://github.com/openvinotoolkit/openvino.genai>`__
-* :doc:`OpenVINO Installation Guide <../install-openvino>`
-* :doc:`OpenVINO Tokenizers <../../openvino-workflow-generative/ov-tokenizers>`
+* :doc:`OpenVINO Installation Guide <../../install-openvino>`
+* :doc:`OpenVINO Tokenizers <../../../openvino-workflow-generative/ov-tokenizers>`
 
diff --git a/...tarted/troubleshooting-install-config.rst → ...ations/troubleshooting-install-config.rst b/...tarted/troubleshooting-install-config.rst → ...ations/troubleshooting-install-config.rst
@@ -37,8 +37,8 @@ Troubleshooting Guide for OpenVINO™ Installation & Configuration
    This error may appear on systems lacking C++ components. Since it is almost exclusively a
    Windows case, installing `Microsoft Visual C++ Redistributable [vc_redist.x64] <https://aka.ms/vs/17/release/vc_redist.x64.exe>`__
    package may fix it. For more information on dependencies, check
-   :doc:`System Requirements <../about-openvino/release-notes-openvino/system-requirements>` and
-   :doc:`Additional Hardware Configurations <./configurations>`
+   :doc:`System Requirements <../../../about-openvino/release-notes-openvino/system-requirements>` and
+   :doc:`Additional Hardware Configurations and Troubleshooting <../configurations>`
 
 .. dropdown:: Proxy issues installing OpenVINO on Linux from Docker
 
@@ -122,10 +122,10 @@ Troubleshooting Guide for OpenVINO™ Installation & Configuration
 
 .. dropdown:: Check if proper drivers are installed
 
-   :doc:`Additional configurations <configurations>` may be
+   :doc:`Additional configurations <../configurations>` may be
    required in order to use OpenVINO with different hardware, such as Intel® GPU and NPU.
    Make sure that the device you want to use for inference has the required driver installed,
-   as described in :doc:`additional configurations for GPU <configurations/configurations-intel-gpu>`.
+   as described in :doc:`additional configurations for GPU <./configurations-intel-gpu>`.
 
 .. dropdown:: Check firewall and network settings
 

diff --git a/docs/articles_en/get-started/install-openvino/install-openvino-apt.rst b/docs/articles_en/get-started/install-openvino/install-openvino-apt.rst
@@ -152,7 +152,7 @@ Run the following command:
 
 Congratulations! You've just Installed OpenVINO! For some use cases you may still
 need to install additional components. Check the
-:doc:`list of additional configurations <../configurations>`
+:doc:`list of additional configurations <./configurations>`
 to see if your case needs any of them.
 
 With the APT distribution, you can build OpenVINO sample files, as explained in the

diff --git a/docs/articles_en/get-started/install-openvino/install-openvino-archive-linux.rst b/docs/articles_en/get-started/install-openvino/install-openvino-archive-linux.rst
@@ -171,7 +171,7 @@ Step 1: Download and Install the OpenVINO Core Components
 
 Congratulations, you have finished the installation! For some use cases you may still
 need to install additional components. Check the description below, as well as the
-:doc:`list of additional configurations <../configurations>`
+:doc:`list of additional configurations <./configurations>`
 to see if your case needs any of them.
 
 The ``/opt/intel/openvino_2024`` folder now contains the core components for OpenVINO.
@@ -273,7 +273,7 @@ To delete the files:
 Additional Resources
 ###########################################################
 
-* :doc:`Troubleshooting Guide for OpenVINO Installation & Configuration <../troubleshooting-install-config>`
+* :doc:`Troubleshooting Guide for OpenVINO Installation & Configuration <./configurations/troubleshooting-install-config>`
 * Converting models for use with OpenVINO™: :doc:`Convert a Model <../../../openvino-workflow/model-preparation>`
 * Writing your own OpenVINO™ applications: :doc:`OpenVINO™ Runtime User Guide <../../../openvino-workflow/running-inference>`
 * Sample applications: :doc:`OpenVINO™ Toolkit Samples Overview <../../../learn-openvino/openvino-samples>`

diff --git a/docs/articles_en/get-started/install-openvino/install-openvino-archive-macos.rst b/docs/articles_en/get-started/install-openvino/install-openvino-archive-macos.rst
@@ -100,7 +100,7 @@ Step 1: Install OpenVINO Core Components
 
 Congratulations, you have finished the installation! For some use cases you may still
 need to install additional components. Check the description below, as well as the
-:doc:`list of additional configurations <../configurations>`
+:doc:`list of additional configurations <./configurations>`
 to see if your case needs any of them.
 
 The ``/opt/intel/openvino_2024`` folder now contains the core components for OpenVINO.

diff --git a/docs/articles_en/get-started/install-openvino/install-openvino-archive-windows.rst b/docs/articles_en/get-started/install-openvino/install-openvino-archive-windows.rst
@@ -95,7 +95,7 @@ Step 1: Download and Install OpenVINO Core Components
 
 Congratulations, you have finished the installation! For some use cases you may still
 need to install additional components. Check the description below, as well as the
-:doc:`list of additional configurations <../configurations>`
+:doc:`list of additional configurations <./configurations>`
 to see if your case needs any of them.
 
 The ``C:\Program Files (x86)\Intel\openvino_2024`` folder now contains the core components for OpenVINO.

diff --git a/docs/articles_en/get-started/install-openvino/install-openvino-brew.rst b/docs/articles_en/get-started/install-openvino/install-openvino-brew.rst
@@ -37,7 +37,7 @@ Installing OpenVINO Runtime
 
 Congratulations! You've just Installed OpenVINO! For some use cases you may still
 need to install additional components. Check the
-:doc:`list of additional configurations <../configurations>`
+:doc:`list of additional configurations <./configurations>`
 to see if your case needs any of them.
 
 

diff --git a/docs/articles_en/get-started/install-openvino/install-openvino-conda.rst b/docs/articles_en/get-started/install-openvino/install-openvino-conda.rst
@@ -46,7 +46,7 @@ Installing OpenVINO Runtime with Anaconda Package Manager
 
 Congratulations! You've just Installed OpenVINO! For some use cases you may still
 need to install additional components. Check the description below, as well as the
-:doc:`list of additional configurations <../configurations>`
+:doc:`list of additional configurations <./configurations>`
 to see if your case needs any of them.
 
 Enabling GPU device for inference

diff --git a/docs/articles_en/get-started/install-openvino/install-openvino-pip.rst b/docs/articles_en/get-started/install-openvino/install-openvino-pip.rst
@@ -104,7 +104,7 @@ If installation was successful, you will see the list of available devices.
 
 Congratulations! You've just Installed OpenVINO! For some use cases you may still
 need to install additional components. Check the
-:doc:`list of additional configurations <../configurations>`
+:doc:`list of additional configurations <./configurations>`
 to see if your case needs any of them.
 
 

diff --git a/docs/articles_en/get-started/install-openvino/install-openvino-vcpkg.rst b/docs/articles_en/get-started/install-openvino/install-openvino-vcpkg.rst
@@ -61,7 +61,7 @@ And running from terminal:
 
 Congratulations! You've just Installed and used OpenVINO in your project! For some use cases you may still
 need to install additional components. Check the
-:doc:`list of additional configurations <../configurations>`
+:doc:`list of additional configurations <./configurations>`
 to see if your case needs any of them.
 
 Uninstalling OpenVINO

diff --git a/docs/articles_en/get-started/install-openvino/install-openvino-yocto.rst b/docs/articles_en/get-started/install-openvino/install-openvino-yocto.rst
@@ -104,7 +104,7 @@ If the image build is successful, it will return the list of packages as below:
 Additional Resources
 ####################
 
-- :doc:`Troubleshooting Guide <../troubleshooting-install-config>`
+- :doc:`Troubleshooting Guide <./configurations/troubleshooting-install-config>`
 - `Official Yocto Project documentation <https://docs.yoctoproject.org/>`__
 - `BitBake Tool <https://docs.yoctoproject.org/bitbake/>`__
 - `Poky <https://git.yoctoproject.org/poky>`__

diff --git a/docs/articles_en/get-started/install-openvino/install-openvino-yum.rst b/docs/articles_en/get-started/install-openvino/install-openvino-yum.rst
@@ -113,7 +113,7 @@ Run the following command:
 
 Congratulations! You've just Installed OpenVINO! For some use cases you may still
 need to install additional components. Check the
-:doc:`list of additional configurations <../configurations>`
+:doc:`list of additional configurations <./configurations>`
 to see if your case needs any of them.
 
 With the YUM distribution, you can build OpenVINO sample files, as explained in the

diff --git a/docs/articles_en/get-started/install-openvino/install-openvino-zypper.rst b/docs/articles_en/get-started/install-openvino/install-openvino-zypper.rst
@@ -65,7 +65,7 @@ Run the following command:
 
 Congratulations! You've just Installed OpenVINO! For some use cases you may still
 need to install additional components. Check the
-:doc:`list of additional configurations <../configurations>`
+:doc:`list of additional configurations <./configurations>`
 to see if your case needs any of them.
 
 With the ZYPPER distribution, you can build OpenVINO sample files, as explained in the

diff --git a/docs/articles_en/learn-openvino/openvino-samples/get-started-demos.rst b/docs/articles_en/learn-openvino/openvino-samples/get-started-demos.rst
@@ -409,7 +409,7 @@ The following command shows how to run the Image Classification Code Sample usin
 
 .. note::
 
-   * Running inference on Intel® Processor Graphics (GPU) requires :doc:`additional hardware configuration steps <../../get-started/configurations/configurations-intel-gpu>`, as described earlier on this page.
+   * Running inference on Intel® Processor Graphics (GPU) requires :doc:`additional hardware configuration steps <../../get-started/install-openvino/configurations/configurations-intel-gpu>`, as described earlier on this page.
    * Running on GPU is not compatible with macOS.
 
 .. tab-set::

diff --git a/docs/articles_en/openvino-workflow/deployment-locally.rst b/docs/articles_en/openvino-workflow/deployment-locally.rst
@@ -74,5 +74,5 @@ Building a local distribution will require more detailed information, and you wi
 
 .. note::
 
-   Depending on your target OpenVINO devices, the following configuration might be needed for deployed machines: :doc:`Configurations for GPU <../get-started/configurations/configurations-intel-gpu>`.
+   Depending on your target OpenVINO devices, the following configuration might be needed for deployed machines: :doc:`Configurations for GPU <../get-started/install-openvino/configurations/configurations-intel-gpu>`.
 
diff --git a/.../openvino-workflow/running-inference/inference-devices-and-modes/gpu-device.rst b/.../openvino-workflow/running-inference/inference-devices-and-modes/gpu-device.rst
@@ -21,7 +21,7 @@ For an in-depth description of the GPU plugin, see:
 - `OpenVINO Runtime GPU plugin source files <https://github.com/openvinotoolkit/openvino/tree/master/src/plugins/intel_gpu/>`__
 - `Start AI Development with Intel <https://www.intel.com/content/www/us/en/developer/topic-technology/artificial-intelligence/overview.html>`__
 
-The GPU plugin is a part of the Intel® Distribution of OpenVINO™ toolkit. For more information on how to configure a system to use it, see the :doc:`GPU configuration <../../../get-started/configurations/configurations-intel-gpu>`.
+The GPU plugin is a part of the Intel® Distribution of OpenVINO™ toolkit. For more information on how to configure a system to use it, see the :doc:`GPU configuration <../../../get-started/install-openvino/configurations/configurations-intel-gpu>`.
 
 Device Naming Convention
 #######################################

diff --git a/docs/dev/pypi_publish/pypi-openvino-rt.md b/docs/dev/pypi_publish/pypi-openvino-rt.md
@@ -122,7 +122,7 @@ If installation was successful, you will see the list of available devices.
 ## Troubleshooting
 
 For general troubleshooting, see the
-[Troubleshooting Guide for OpenVINO Installation](https://docs.openvino.ai/2025/get-started/troubleshooting-install-config.html).
+[Troubleshooting Guide for OpenVINO Installation](https://docs.openvino.ai/2025/get-started/install-openvino/configurations/troubleshooting-install-config.html).
 The following sections also provide explanations to several error messages.
 
 ### Errors with Installing via PIP for Users in China
Original file line number	Diff line number	Diff line change
Expand Up		@@ -74,5 +74,5 @@ Building a local distribution will require more detailed information, and you wi

		.. note::

		Depending on your target OpenVINO devices, the following configuration might be needed for deployed machines: :doc:`Configurations for GPU <../get-started/configurations/configurations-intel-gpu>`.
		Depending on your target OpenVINO devices, the following configuration might be needed for deployed machines: :doc:`Configurations for GPU <../get-started/install-openvino/configurations/configurations-intel-gpu>`.