Added specification to doc directory

doc/conf.py

@@ -23,6 +23,11 @@
 
 BUILD_TYPE = os.getenv("BUILD_TYPE")
 
+# Set up tags for conditional content
+# Tags allow using .. only:: directives in RST files
+if BUILD_TYPE == 'oss' or BUILD_TYPE is None:
+    tags.add('oss')
+
 # -- Project information -----------------------------------------------------
 
 if BUILD_TYPE == 'oneapi' or BUILD_TYPE == 'dita':
@@ -83,7 +88,19 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This pattern also affects html_static_path and html_extra_path.
-exclude_patterns = []
+# Base exclude patterns - specification files that should never be built
+exclude_patterns = [
+    'main/specification/source/nested-*.rst',
+    'main/specification/source/uncategorized.rst',
+    'main/specification/source/uncategorized/**',
+    'main/specification/source/low_level_task_api.rst',
+    'main/specification/source/low_level_tasking/**',
+]
+
+# Specification is only included in OSS builds (GitHub Pages)
+# Intel builds (oneapi/dita) automatically exclude the entire specification directory
+if BUILD_TYPE == 'oneapi' or BUILD_TYPE == 'dita':
+    exclude_patterns.append('main/specification/**')
 
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = None
@@ -96,6 +113,7 @@
 .. |full_name| replace:: Intel\ |reg|\  oneAPI Threading Building Blocks (oneTBB)
 .. |short_name| replace:: oneTBB
 .. |product| replace:: oneTBB
+.. |tbb_version| replace:: 1.5
 .. |reg| unicode:: U+000AE
 .. |copy| unicode:: U+000A9
 .. |base_tk| replace:: Intel\ |reg|\  oneAPI Base Toolkit
@@ -106,6 +124,7 @@
 .. |full_name| replace:: oneAPI Threading Building Blocks (oneTBB)
 .. |short_name| replace:: oneTBB
 .. |product| replace:: oneTBB
+.. |tbb_version| replace:: 1.5
 .. |reg| unicode:: U+000AE
 .. |copy| unicode:: U+000A9
 .. |base_tk| replace:: Intel\ |reg|\  oneAPI Base Toolkit

doc/index/toctree.rst

@@ -40,3 +40,11 @@
    :caption: Developer Reference
 
    /main/reference/reference
+
+
+.. toctree::
+   :maxdepth: 3
+   :hidden:
+   :caption: Specification
+
+   /main/specification/source/index

doc/main/reference/reference.rst

@@ -3,14 +3,19 @@
 |short_name| API Reference
 ==========================
 
-For oneTBB API Reference, refer to `oneAPI Specification <https://github.com/uxlfoundation/oneAPI-spec>`_. The current supported
-version of oneAPI Specification is 1.0.
+.. only:: oss
+
+   For oneTBB API Reference, refer to the :doc:`oneTBB Specification </main/specification/source/index>`.
+
+.. only:: not oss
+
+   For oneTBB API Reference, refer to the `oneTBB Specification <https://uxlfoundation.github.io/oneTBB/main/specification/source/index.html>`_.
+   The current supported version of the oneTBB specification is 1.5.
 
 Specification extensions
 ************************
 
-|full_name| implements the `oneTBB specification <https://oneapi-spec.uxlfoundation.org/specifications/oneapi/latest/elements/onetbb/source/nested-index>`_.
-This document provides additional details or restrictions where necessary.
+|full_name| implements the oneTBB specification. This document provides additional details or restrictions beyond the specification.
 It also describes features that are not included in the oneTBB specification.
 
 .. toctree::

doc/main/specification/source/algorithms.rst

@@ -0,0 +1,66 @@
+.. SPDX-FileCopyrightText: 2019-2021 Intel Corporation
+..
+.. SPDX-License-Identifier: CC-BY-4.0
+
+==========
+Algorithms
+==========
+**[algorithms]**
+
+oneAPI Threading Building Blocks provides a set of generic parallel algorithms.
+
+Parallel Functions
+------------------
+
+.. toctree::
+   :titlesonly:
+
+   algorithms/functions/collaborative_call_once_func.rst
+
+   algorithms/functions/parallel_for_func.rst
+   algorithms/functions/parallel_reduce_func.rst
+   algorithms/functions/parallel_deterministic_reduce_func.rst
+   algorithms/functions/parallel_scan_func.rst
+
+   algorithms/functions/parallel_for_each_func.rst
+
+   algorithms/functions/parallel_invoke_func.rst
+   algorithms/functions/parallel_pipeline_func.rst
+   algorithms/functions/parallel_sort_func.rst
+
+Blocked Ranges
+--------------
+
+Types that meet the :doc:`Range requirements <named_requirements/algorithms/range>`.
+
+.. toctree::
+   :titlesonly:
+
+   algorithms/blocked_ranges/blocked_range_cls.rst
+   algorithms/blocked_ranges/blocked_range2d_cls.rst
+   algorithms/blocked_ranges/blocked_range3d_cls.rst
+   algorithms/blocked_ranges/blocked_nd_range_cls.rst
+
+.. _Partitioners:
+
+Partitioners
+------------
+
+A partitioner specifies how a loop template should partition its work among threads.
+
+.. toctree::
+   :titlesonly:
+
+   algorithms/partitioners/auto_partitioner.rst
+   algorithms/partitioners/affinity_partitioner.rst
+   algorithms/partitioners/static_partitioner.rst
+   algorithms/partitioners/simple_partitioner.rst
+
+Split Tags
+----------
+
+.. toctree::
+   :titlesonly:
+
+   algorithms/split_tags/proportional_split_cls.rst
+   algorithms/split_tags/split_cls.rst