..
   # *******************************************************************************
   # Copyright (c) 2026 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
   # *******************************************************************************

.. _user_manual:

User Manual
###########

.. document:: User Manual <module name>
   :id: doc__user_manual
   :status: draft
   :version: 1
   :safety: QM
   :security: NO
   :realizes: wp__training_path[version==1]


.. attention::
    Update the document metadata according to your needs.

Overview
========

This user manual provides comprehensive guidance for using the [Your Module Name] module from an end customer perspective.
It covers installation, configuration, basic usage, and best practices for integrating this module
into your project.

.. note::
   This is a template user manual. Replace placeholder text with actual module-specific information.

For build and test of the module itself, please refer to the :ref:`quick-start-building-testing`.

Environment Needs
=================

Basic needed software environment for the module development and usage:

* **C++**: C++17 or later
* **Rust**: 1.70 or later (if Rust support is included)
* **Build System**: Bazel 6.0 or later
* **Operating Systems**: Linux, QNX

Dependencies
------------

[List key external dependencies, licenses, and version requirements]

**Example:**

* Standard library (STL/Core)
* [Other required libraries]

See also MODULE.bazel files for more details on dependencies.

Module Configuration Details
=============================

<A detailed explanation of the module configuration which can be done by end users, including the purpose and effects of the settings might be explained in the files in the config subdirectory.>

Configuration Effects
---------------------

<Explain how the configuration settings affect the module's behavior, performance, and integration with other components. Include examples of typical configurations and their outcomes.>


Examples
========

<Useful examples and tutorials should be provided in the ``examples/`` directory. Link to specific examples here.>

API Reference
=============

For complete and detailed API documentation and descriptions, refer to the API documentation in the ``api_description/`` directory.

Performance Considerations
==========================

This section covers performance characteristics, optimization strategies, and resource requirements.
Refer to the ``performance/`` directory for detailed performance guides and benchmarks.

Integration Guidelines
======================

Integrating with Your Project
------------------------------

1. Add the module to your Bazel workspace:

   .. code-block:: python

      # In your MODULE.bazel
      bazel_dep(name = "module_template", version = "1.0")

2. Reference in your build files:

   .. code-block:: python

      cc_library(
          name = "my_target",
          deps = ["@module_template//score/component_example:component"],
      )

3. Include headers and compile your code


Version History, Compatibility, and Troubleshooting
===================================================

For comprehensive information on the following topics, refer to :doc:`/docs/release/release_note`:

* Version history and changes
* Compatibility notes and upgrade instructions
* Known issues and limitations
* Troubleshooting tips and solutions
* Security vulnerabilities (CVEs)

Safety and Security
===================

**Safety-Critical Usage**: If you are using this module in a safety-critical context,
please refer to :doc:`safety_manual` for detailed safety requirements and guidelines.

**Security Considerations**: For information about security aspects and requirements,
please refer to :doc:`security_manual`.

License
=======

This module is licensed under the Apache License Version 2.0.
See the LICENSE file in the repository for full license text.

Feedback and Contributions
==========================

Your feedback and contributions are welcome! Please report issues or suggestions through the
project's issue tracker or contribute directly to the repository.