..  # *******************************************************************************
    # Copyright (c) 2025 Contributors to the Eclipse Foundation
    #
    # See the NOTICE file(s) distributed with this work for additional
    # information regarding copyright ownership.
    #
    # This program and the accompanying materials are made available under the
    # terms of the Apache License Version 2.0 which is available at
    # https://www.apache.org/licenses/LICENSE-2.0
    #
    # SPDX-License-Identifier: Apache-2.0
    # *******************************************************************************

.. _extensions:


==========
Extensions
==========

Hello there


.. grid:: 1 1 3 3
   :class-container: score-grid

   .. grid-item-card::

      Metamodel
      ^^^
      Learn more about our Metamodel extension and what this extension takes care of.
      :ref:`Metamodel Extension<metamodel>`.

   .. grid-item-card::

      Header Service
      ^^^
      Learn about the Header Service extension, and how you can configure it.
      It creates RST Tables and automatically fills our information needed.
      :ref:`Header Service Extension <header-service>`

   .. grid-item-card::

      Source Code Linker
      ^^^
      Learn about the Source Code Linker extension, and how you can configure it.
      It enables the possibility to link source code to requirements.
      :ref:`Source Code Linker Extension <source-code-linker>`

   .. grid-item-card::

      RST Filebased testing
      ^^^
      A new testing approach that we have integrated. It makes it easy to ensure that the metamodel and it's checks
      work as intended. Create new checks simply by writing RST files.
      Head over to :ref:`File Based Testing <file-based-testing>` to learn more.

   .. grid-item-card::

      Extension Guide
      ^^^
      Want to learn how to write your own sphinx extension, or see how others have done it?
      Head over to :ref:`Building an Extension<extension-guide>` to dive in.

   .. grid-item-card::

      Sync TOML
      ^^^
      Learn about the :ref:`config sync <toml_sync>` extension that generates the
      ``ubproject.toml`` file needed by the
      `ubCode <https://ubcode.useblocks.com>`__ VS Code extension.
      Getting IDE support for Sphinx-Needs in a Bazel context made easy.



.. toctree::
   :maxdepth: 1
   :caption: Contents:

   Metamodel <metamodel>
   Filebased Testing <rst_filebased_testing>
   Header Service <header_service>
   Source Code Linker <source_code_linker>
   Extension Guide <extension_guide>
   Sync TOML <sync_toml>