Docs/sphinx site migration

.github/CODEOWNERS

@@ -0,0 +1,83 @@
+# ------------------------------------------------------------------------------
+# BIOMASS BPS Code Owners
+# SPDX-FileCopyrightText: 2026 European Space Agency (ESA) - ACRI-ST
+# SPDX-License-Identifier: Apache-2.0
+#
+# Rules:
+#   - Last matching line wins.
+#   - Only users with WRITE access can be code owners.
+#   - Personal repos accept @usernames only (no @org/team syntax).
+#   - Replace @handles below with real GitHub usernames before enforcing.
+#
+# ESA repository gate (documented in docs/governance/repository-stewards.md):
+#   - Klaus Scipal ESA final authority (disputes, release gate)
+#   - Clement Albinet ESA repository representative
+# ------------------------------------------------------------------------------
+
+# ---- Catch-all: Core Maintainer reviews anything not matched below -----------
+*                                       @matteoaletti
+
+# ---- CI / CD / repo governance -----------------------------------------------
+/.github/                               @yreyricord
+/.pre-commit-config.yaml                @matteoaletti
+/REUSE.toml                             @yreyricord
+/LICENSES/                              @yreyricord
+/pyproject.toml                         @matteoaletti
+/pytest.ini                             @matteoaletti
+/ruff.toml                              @matteoaletti
+/noxfile.py                             @matteoaletti
+/.gitignore                             @matteoaletti
+/.secrets.baseline                      @matteoaletti
+
+# ---- Shared libraries (technical: R. Piantanida) ----------------------------
+/bps-common/                            @matteoaletti
+/bps-task-tables/                       @matteoaletti
+/bps-transcoder/                        @matteoaletti
+
+# ---- L1 processors (scientific: S. Tebaldini) -------------------------------
+/bps-l1_binaries/                       @matteoaletti
+/bps-l1_core_processor/                 @matteoaletti
+/bps-l1_framing_processor/              @matteoaletti
+/bps-l1_pre_processor/                  @matteoaletti
+/bps-l1_processor/                      @matteoaletti
+
+# ---- L2 processors -----------------------------------------------------------
+/bps-l2a_processor/                     @matteoaletti
+/bps-l2b_agb_processor/                 @matteoaletti
+/bps-l2b_fd_processor/                  @matteoaletti
+/bps-l2b_fh_processor/                  @matteoaletti
+
+# ---- Stack processors --------------------------------------------------------
+/bps-stack_binaries/                    @matteoaletti
+/bps-stack_cal_processor/               @matteoaletti
+/bps-stack_coreg_processor/             @matteoaletti
+/bps-stack_pre_processor/               @matteoaletti
+/bps-stack_processor/                   @matteoaletti
+
+# ---- Container / packaging ---------------------------------------------------
+/bps-dockerfiles/                       @matteoaletti
+
+# ---- Tests -------------------------------------------------------------------
+/test/                                  @matteoaletti
+**/tests/unit/                          @matteoaletti
+**/tests/integration/                   @matteoaletti
+**/tests/fixtures/                      @matteoaletti
+**/tests/baseline/                      @matteoaletti
+**/tests/smoke/                         @matteoaletti
+/tests/extended/                        @matteoaletti
+/tests/heavy/                           @matteoaletti
+
+# ---- Documentation -----------------------------------------------------------
+/README.md                              @matteoaletti
+/CREDITS.md                             @matteoaletti
+/LICENSE.md                             @yreyricord
+/docs/                                  @yreyricord
+
+# ---- Scripts & schemas -------------------------------------------------------
+/scripts/                               @matteoaletti
+/xsd/                                   @matteoaletti
+
+# ---- Release gate (ESA approval mandatory) ----------------------------------
+# Replace @handles with Klaus Scipal (final authority) and Clement Albinet GitHub usernames.
+/VERSION                                @matteoaletti
+/CHANGELOG.md                           @matteoaletti

.github/ISSUE_TEMPLATE/01_bug_report.yml

@@ -0,0 +1,137 @@
+# SPDX-FileCopyrightText: 2026 European Space Agency (ESA) - ACRI-ST
+# SPDX-License-Identifier: Apache-2.0
+
+name: 01 · Bug report
+description: Report a defect in a processor, the CI/CD pipeline, or the documentation.
+title: "[bug] <short description>"
+labels: ["type:bug", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please complete this form to report a defect in the BIOMASS BPS software,
+        the CI/CD pipeline, or the documentation. The more reproducible the report,
+        the faster the issue can be diagnosed and resolved.
+
+  - type: dropdown
+    id: component
+    attributes:
+      label: Affected component
+      description: Select the part of BIOMASS BPS impacted by this defect.
+      options:
+        - bps-common
+        - bps-dockerfiles
+        - bps-l1_binaries
+        - bps-l1_core_processor
+        - bps-l1_framing_processor
+        - bps-l1_pre_processor
+        - bps-l1_processor
+        - bps-l2a_processor
+        - bps-l2b_agb_processor
+        - bps-l2b_fd_processor
+        - bps-l2b_fh_processor
+        - bps-stack_binaries
+        - bps-stack_cal_processor
+        - bps-stack_coreg_processor
+        - bps-stack_pre_processor
+        - bps-stack_processor
+        - bps-task-tables
+        - bps-transcoder
+        - CI / GitHub Actions
+        - Documentation
+        - Other (please specify in the description)
+    validations:
+      required: true
+
+  - type: dropdown
+    id: severity
+    attributes:
+      label: Severity
+      description: Operational impact of the defect.
+      options:
+        - Critical - blocks the processing chain
+        - Major - incorrect scientific output
+        - Minor - degraded behaviour with workaround
+        - Cosmetic - documentation or display only
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: Version or commit reference
+      description: Output of `git describe --tags --always`, or the release tag, or the commit SHA.
+      placeholder: "v4.4.4  or  a1b2c3d"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: environment
+    attributes:
+      label: Environment
+      options:
+        - Local developer environment
+        - GitHub Actions (CI)
+        - MAAP
+        - Operational deployment
+        - Jupyter Notebook
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: Observed behaviour
+      description: A clear and concise description of the defect.
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behaviour
+      description: What was expected to happen instead.
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to reproduce
+      description: Minimal, deterministic sequence of commands or actions.
+      value: |
+        1.
+        2.
+        3.
+      render: markdown
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs and traceback
+      description: Relevant log output or Python traceback. Will be rendered as a code block.
+      render: shell
+
+  - type: textarea
+    id: additional_context
+    attributes:
+      label: Additional context
+      description: |
+        Optional. Suspected root cause, relevant file paths, links to related issues
+        or pull requests, screenshots, references, or any other context that may
+        help triage.
+
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Pre-submission checklist
+      options:
+        - label: I have searched existing issues and confirmed this is not a duplicate.
+          required: true
+        - label: I am running a supported version (a tagged release or the current `develop` branch).
+          required: true
+        - label: I have included enough information for the defect to be reproduced.
+          required: true

.github/ISSUE_TEMPLATE/02_feature_request.yml

@@ -0,0 +1,112 @@
+# SPDX-FileCopyrightText: 2026 European Space Agency (ESA) - ACRI-ST
+# SPDX-License-Identifier: Apache-2.0
+
+name: 02 · Feature or enhancement request
+description: Propose a non-scientific feature, an enhancement, or a tooling improvement.
+title: "[feature] <short description>"
+labels: ["type:feature", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this template to propose a software feature, an enhancement to an existing
+        component, or a tooling improvement.
+
+        For the proposal of a new scientific algorithm or a methodological change,
+        please use the **Algorithm proposal** template instead.
+
+  - type: dropdown
+    id: scope
+    attributes:
+      label: Scope of the proposal
+      options:
+        - New software feature
+        - Enhancement to an existing component
+        - Performance or scalability improvement
+        - CI/CD or tooling improvement
+        - Governance or process improvement
+        - Other
+    validations:
+      required: true
+
+  - type: dropdown
+    id: component
+    attributes:
+      label: Most impacted component
+      options:
+        - bps-common
+        - bps-dockerfiles
+        - bps-l1_binaries
+        - bps-l1_core_processor
+        - bps-l1_framing_processor
+        - bps-l1_pre_processor
+        - bps-l1_processor
+        - bps-l2a_processor
+        - bps-l2b_agb_processor
+        - bps-l2b_fd_processor
+        - bps-l2b_fh_processor
+        - bps-stack_binaries
+        - bps-stack_cal_processor
+        - bps-stack_coreg_processor
+        - bps-stack_pre_processor
+        - bps-stack_processor
+        - bps-task-tables
+        - bps-transcoder
+        - CI / GitHub Actions
+        - Documentation
+        - Not specific to one component
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem statement and motivation
+      description: What problem does this address? Who is affected and why does it matter?
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: Describe the proposed change in concrete terms.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Other approaches that were considered and reasons for rejection.
+
+  - type: textarea
+    id: impact
+    attributes:
+      label: Expected impact
+      description: |
+        Discuss backward compatibility, interfaces, performance, dependencies,
+        documentation and validation impact.
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional_context
+    attributes:
+      label: Additional context
+      description: |
+        Optional. Relevant file paths, links to related issues or pull requests,
+        screenshots, prior art in other projects, references, or any other context
+        that may help triage.
+
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Pre-submission checklist
+      options:
+        - label: I have searched existing issues and discussions for a similar proposal.
+          required: true
+        - label: I have read the contributing guidelines and the project governance.
+          required: true
+        - label: I am available to discuss the design before any implementation starts.
+          required: true