[doc] Update example task paths

aobolensk · aobolensk · commit 67b57a1b5a87 · 2026-06-08T05:25:58.000+02:00
diff --git a/docs/common_information/introduction.rst b/docs/common_information/introduction.rst
@@ -14,7 +14,7 @@ Practice
 - Task distribution is random for each student.
 - Full automation of quality and performance checks; plagiarism checks are applied.
 - Deadlines are set per task. See the penalties and grading rules in ``Points``.
-- Examples are provided in ``tasks/example_threads`` and ``tasks/example_processes`` (and extended variations ``tasks/example_processes_2`` / ``tasks/example_processes_3``).
+- Examples are provided in ``tasks/example/threads`` and ``tasks/example/processes`` (with process variations in ``tasks/example/processes/t1`` / ``tasks/example/processes/t2`` / ``tasks/example/processes/t3``).
 - In each repository, the README.md contains a link to the course documentation.
 - Each repository includes an example of a properly formatted PULL REQUEST.
 - Submission of all tasks is mandatory to pass the course.
diff --git a/docs/locale/en/LC_MESSAGES/common_information/introduction.po b/docs/locale/en/LC_MESSAGES/common_information/introduction.po
@@ -52,10 +52,12 @@ msgstr ""
 msgid "Task distribution is random for each student."
 msgstr ""
 
-#: ../../common_information/introduction.rst:15
+#: ../../common_information/introduction.rst:17
 msgid ""
-"An example for each technology can be found in the corresponding "
-"directory: ``tasks/<all/omp/tbb/seq/stl/mpi>/example``."
+"Examples are provided in ``tasks/example/threads`` and "
+"``tasks/example/processes`` (with process variations in "
+"``tasks/example/processes/t1`` / ``tasks/example/processes/t2`` / "
+"``tasks/example/processes/t3``)."
 msgstr ""
 
 #: ../../common_information/introduction.rst:16
diff --git a/docs/locale/en/LC_MESSAGES/user_guide/build.po b/docs/locale/en/LC_MESSAGES/user_guide/build.po
@@ -57,8 +57,8 @@ msgstr ""
 #: ../../../../docs/user_guide/build.rst:29
 msgid ""
 "``-D PPC_TASKS=all`` builds every task (default). Pass one task or a "
-"semicolon list, for example ``-D PPC_TASKS=\"example_threads;example_processes\"``, "
-"to limit the build."
+"semicolon list, for example ``-D PPC_TASKS=\"example\"``, to limit the "
+"build."
 msgstr ""
 
 #: ../../../../docs/user_guide/build.rst:32
diff --git a/docs/locale/en/LC_MESSAGES/user_guide/submit_work.po b/docs/locale/en/LC_MESSAGES/user_guide/submit_work.po
@@ -241,12 +241,12 @@ msgstr ""
 
 #: ../../../../docs/user_guide/submit_work.rst:218
 msgid ""
-"Processes: ``tasks/example_processes``, ``tasks/example_processes_2``, "
-"``tasks/example_processes_3``"
+"Processes: ``tasks/example/processes/t1``, ``tasks/example/processes/t2``, "
+"``tasks/example/processes/t3``"
 msgstr ""
 
 #: ../../../../docs/user_guide/submit_work.rst:219
-msgid "Threads: ``tasks/example_threads``"
+msgid "Threads: ``tasks/example/threads``"
 msgstr ""
 
 #: ../../../../docs/user_guide/submit_work.rst:221
diff --git a/docs/locale/ru/LC_MESSAGES/common_information/introduction.po b/docs/locale/ru/LC_MESSAGES/common_information/introduction.po
@@ -80,10 +80,11 @@ msgstr "Дедлайны задаются на каждую задачу. Под
 
 #: ../../../../docs/common_information/introduction.rst:23
 msgid ""
-"Examples are provided in ``tasks/example_threads`` and "
-"``tasks/example_processes`` (and extended variations "
-"``tasks/example_processes_2`` / ``tasks/example_processes_3``)."
-msgstr "Примеры размещены в ``tasks/example_threads`` и ``tasks/example_processes`` (а также расширенные варианты: ``tasks/example_processes_2`` / ``tasks/example_processes_3``)."
+"Examples are provided in ``tasks/example/threads`` and "
+"``tasks/example/processes`` (with process variations in "
+"``tasks/example/processes/t1`` / ``tasks/example/processes/t2`` / "
+"``tasks/example/processes/t3``)."
+msgstr "Примеры размещены в ``tasks/example/threads`` и ``tasks/example/processes`` (варианты для процессов: ``tasks/example/processes/t1`` / ``tasks/example/processes/t2`` / ``tasks/example/processes/t3``)."
 
 #: ../../../../docs/common_information/introduction.rst:24
 msgid ""
diff --git a/docs/locale/ru/LC_MESSAGES/user_guide/build.po b/docs/locale/ru/LC_MESSAGES/user_guide/build.po
@@ -57,13 +57,12 @@ msgstr "``-D USE_PERF_TESTS=ON`` включает тесты на произво
 #: ../../../../docs/user_guide/build.rst:29
 msgid ""
 "``-D PPC_TASKS=all`` builds every task (default). Pass one task or a "
-"semicolon list, for example ``-D PPC_TASKS=\"example_threads;example_processes\"``, "
-"to limit the build."
+"semicolon list, for example ``-D PPC_TASKS=\"example\"``, to limit the "
+"build."
 msgstr ""
 "``-D PPC_TASKS=all`` собирает все задачи (по умолчанию). Укажите одну "
 "задачу или список через точку с запятой, например "
-"``-D PPC_TASKS=\"example_threads;example_processes\"``, чтобы ограничить "
-"сборку."
+"``-D PPC_TASKS=\"example\"``, чтобы ограничить сборку."
 
 #: ../../../../docs/user_guide/build.rst:32
 msgid ""
diff --git a/docs/locale/ru/LC_MESSAGES/user_guide/submit_work.po b/docs/locale/ru/LC_MESSAGES/user_guide/submit_work.po
@@ -292,15 +292,15 @@ msgstr "Полезные примеры для ориентирования"
 
 #: ../../../../docs/user_guide/submit_work.rst:218
 msgid ""
-"Processes: ``tasks/example_processes``, ``tasks/example_processes_2``, "
-"``tasks/example_processes_3``"
+"Processes: ``tasks/example/processes/t1``, ``tasks/example/processes/t2``, "
+"``tasks/example/processes/t3``"
 msgstr ""
-"Процессы: ``tasks/example_processes``, ``tasks/example_processes_2``, "
-"``tasks/example_processes_3``"
+"Процессы: ``tasks/example/processes/t1``, ``tasks/example/processes/t2``, "
+"``tasks/example/processes/t3``"
 
 #: ../../../../docs/user_guide/submit_work.rst:219
-msgid "Threads: ``tasks/example_threads``"
-msgstr "Потоки: ``tasks/example_threads``"
+msgid "Threads: ``tasks/example/threads``"
+msgstr "Потоки: ``tasks/example/threads``"
 
 #: ../../../../docs/user_guide/submit_work.rst:221
 msgid ""
diff --git a/docs/user_guide/build.rst b/docs/user_guide/build.rst
@@ -13,7 +13,7 @@ Navigate to the project root.
 
    .. code-block:: bash
 
-      cmake -S . -B build -DPPC_TASKS="example_threads;example_processes"
+      cmake -S . -B build -DPPC_TASKS="example"
 
    Optional: enable sanitizers for local debugging
 
@@ -27,8 +27,7 @@ Navigate to the project root.
    - ``-D USE_FUNC_TESTS=ON`` enable functional tests.
    - ``-D USE_PERF_TESTS=ON`` enable performance tests.
    - ``-D PPC_TASKS=all`` builds every task (default). Pass one task or a semicolon list,
-     for example ``-D PPC_TASKS="example_threads;example_processes"``, to limit
-     the build.
+     for example ``-D PPC_TASKS="example"``, to limit the build.
    - ``-D PPC_IMPLEMENTATIONS="seq;omp"`` select implementation folders to
      configure.
    - ``-D CMAKE_BUILD_TYPE=Release`` normal build (default).
diff --git a/docs/user_guide/submit_work.rst b/docs/user_guide/submit_work.rst
@@ -188,8 +188,8 @@ Common pitfalls (read before pushing)
 
 Useful examples to reference
 ----------------------------
-- Processes: ``tasks/example_processes``, ``tasks/example_processes_2``, ``tasks/example_processes_3``
-- Threads: ``tasks/example_threads``
+- Processes: ``tasks/example/processes/t1``, ``tasks/example/processes/t2``, ``tasks/example/processes/t3``
+- Threads: ``tasks/example/threads``
 
 - Work from your fork in a dedicated branch (not ``master``). Branch name must match your task folder.
 
