Set up tutorial documentation

.gitattributes

@@ -1,5 +1,5 @@
 # Notebooks are not application code: keep them out of the language statistics.
-tutorial*/** linguist-vendored=true
+tutorials/** linguist-vendored=true
 
 # Data files are binary, not text.
 *.pt binary

.github/CODEOWNERS

@@ -1,22 +1,22 @@
 # CODEOWNERS file for PINA-Tutorials
 
 # Default owners for everything in the repo
-*                @mathLab/pina-developers
+*                @PINA-org/pina-maintainers
 
 # Tutorial content
-tutorial*/       @mathLab/pina-developers
-static/          @mathLab/pina-developers
+tutorials/       @PINA-org/pina-maintainers
+static/          @PINA-org/pina-maintainers
 
 # Project-wide config
-pyproject.toml   @mathLab/pina-developers @ndem0
-.gitignore       @ndem0 @dario-coscia
-.gitattributes   @ndem0 @dario-coscia
+pyproject.toml   @PINA-org/pina-committee @ndem0
+.gitignore       @PINA-org/pina-committee
+.gitattributes   @PINA-org/pina-committee
 
 # Workflows
-.github/         @ndem0 @dario-coscia
+.github/         @PINA-org/pina-committee
 
 # Security & policy files
-LICENSE          @FilippoOlivo @GiovanniCanali @ndem0 @dario-coscia
-SECURITY.md      @FilippoOlivo @GiovanniCanali @ndem0 @dario-coscia
-CODE_OF_CONDUCT.md @FilippoOlivo @GiovanniCanali @ndem0 @dario-coscia
-MAINTAINERS.md   @FilippoOlivo @GiovanniCanali @ndem0 @dario-coscia
+LICENSE          @PINA-org/pina-committee
+SECURITY.md      @PINA-org/pina-committee
+CODE_OF_CONDUCT.md @PINA-org/pina-committee
+MAINTAINERS.md   @PINA-org/pina-committee

.github/PULL_REQUEST_TEMPLATE.md

@@ -13,4 +13,3 @@ This PR closes #ISSUE_NUMBER.
 - [ ] The entry has been added to `README.md`, in the right section
 - [ ] Any new dataset or image is committed, and is referenced by URL pointing
       at this repository
-- [ ] External links were checked (no `mathLab/PINA/.../tutorials/` paths remain)

.github/workflows/deployer.yml

@@ -0,0 +1,61 @@
+name: "Deployer"
+
+on:
+  pull_request:
+    branches:
+      - "main"
+  push:
+    branches:
+      - "main"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: deploy-tutorials-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  docs:
+    name: Build documentation
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Install documentation dependencies
+      run: python3 -m pip install ".[docs]"
+
+    - name: Build documentation
+      run: python3 -m sphinx -W --keep-going -b html docs/source docs/build/html
+
+    - name: Upload GitHub Pages artifact
+      if: github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
+      uses: actions/upload-pages-artifact@v3
+      with:
+        path: docs/build/html
+
+  deploy:
+    name: Deploy documentation
+    needs: docs
+    if: github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+    - name: Configure GitHub Pages
+      uses: actions/configure-pages@v5
+
+    - name: Deploy to GitHub Pages
+      id: deployment
+      uses: actions/deploy-pages@v4
+