chore: refactor pull request template for better structure and guidance

- Clearly separate UI (frontend) and API (backend) sections
- Add before/after screenshot table for UI changes
- Include checklists for tasks, testing, documentation, accessibility, etc.
- Preserve Codespaces testing instructions in a collapsible block
- Add visual hints (ASCII art comments) to guide removal of irrelevant sections
- Update API documentation instruction to use `composer openapi`
- Add optional items: browser testing, accessibility, design review, capabilities
- Include AI disclosure checkbox for transparency

This addresses the requirements of issue #5534 and incorporates feedback
from the previous attempt (#6200).

Fixes #5534

Signed-off-by: Guilherme Carvalho <dev.gcarvalho@gmail.com>

Author: guilhermercarvalho

.github/pull_request_template.md

@@ -1,66 +1,83 @@
-### Pull Request Description
+<!--
+  - 🚨 SECURITY INFO
+  -
+  - Before sending a pull request that fixes a security issue please report it via our HackerOne page (https://hackerone.com/nextcloud) following our security policy (https://nextcloud.com/security/). This allows us to coordinate the fix and release without potentially exposing all Nextcloud servers and users in the meantime.
+-->
+
+* Resolves: # <!-- related github issue -->
+
+## Summary
+
+A concise description of what this PR does and why.
+
+## How to test
+
+<details>
+<summary>Instructions for running the app in Codespaces or local development</summary>
+
+1. Open a Codespace using the `LibreSign` repository or start the container with `make dev-setup`.
+2. Build assets (`npm run watch` for frontend, `composer test:unit -- --filter ...` for backend).
+3. Execute the steps required to reproduce the changes (e.g. upload a PDF, open validation screen, call API endpoint).
+4. Verify that the behaviour matches the description above.
+
+Feel free to paste terminal commands or URLs that help reviewers follow along.
+
+</details>
 
+## UI / Front‑end changes
 
-### Related Issue
 <!--
-If this PR is related to an issue, put here, if not, remove this block
+ █████  █████ █████
+▒▒███  ▒▒███ ▒▒███
+ ▒███   ▒███  ▒███
+ ▒███   ▒███  ▒███
+ ▒███   ▒███  ▒███
+ ▒███   ▒███  ▒███
+ ▒▒████████   █████
+  ▒▒▒▒▒▒▒▒   ▒▒▒▒▒
+
+Feel free to remove this section when your PR only affects the backend/API code.
 -->
-Issue Number:
 
-### Pull Request Type
+- [ ] ... <!-- Describe the tasks performed here (e.g., layout adjustment, new feature X) -->
+- [ ] Screenshots before/after (add images or links)
+
+| Before | After |
+| --- | --- |
+| <!-- Add screenshot → | ← Add screenshot → |
+
+<!-- ☀️ Light theme | 🌑 Dark theme → Please test and document both themes (important for Nextcloud apps) -->
+
+- [ ] Tested in multiple browsers (Chrome, Firefox, Safari) – *optional but appreciated*
+- [ ] Accessibility verified (contrast, keyboard navigation, screen reader friendly) – *if applicable*
+- [ ] Design review approved – *optional, link to feedback if available*
+- [ ] User documentation updated (if applicable) – [user manual](https://docs.libresign.coop/user_manual/) / [docs repository](https://github.com/LibreSign/documentation/)
+
+## API / Back‑end changes
 
 <!--
-Please check the type of change your pull request introduces. Remove all that is unrelated and remove the comment block too, maintaining only the type of your PR:
-
-- Bugfix
-- Feature
-- Code style update (formatting, renaming)
-- Refactoring (no functional changes, no api changes)
-- Build related changes
-- Documentation content changes
-- Other (please describe):
+   █████████   ███████████  █████
+  ███▒▒▒▒▒███ ▒▒███▒▒▒▒▒███▒▒███
+ ▒███    ▒███  ▒███    ▒███ ▒███
+ ▒███████████  ▒██████████  ▒███
+ ▒███▒▒▒▒▒███  ▒███▒▒▒▒▒▒   ▒███
+ ▒███    ▒███  ▒███         ▒███
+ █████   █████ █████        █████
+▒▒▒▒▒   ▒▒▒▒▒ ▒▒▒▒▒        ▒▒▒▒▒
+
+Feel free to remove this section when your PR only affects the frontend/UI code.
 -->
 
-### Pull request checklist
+- [ ] ... <!-- Describe the API/service/architecture changes here -->
+- [ ] Unit and/or integration tests added – *required for backend changes*
+- [ ] Capabilities updated (if applicable) – if adding/modifying Nextcloud capabilities
+- [ ] API documentation updated with the command `composer openapi` if necessary <!-- This generates the openapi.json file -->
 
-- [ ] Did you explain or provide a way of how can we test your code ?
-- [ ] If your pull request is related to frontend modifications provide a print of before and after screen
-- [ ] Did you provide a general summary of your changes ?
-- [ ] Try to limit your pull request to one type, submit multiple pull requests if needed
-- [ ] I implemented tests that cover my contribution
+## ✅ Checklist
 
-<details>
-<summary>How to see this running using GitHub Codespaces</summary>
-
-### 1. Open the Codespace
-- Authenticate to GitHub
-- Go to the branch: [chore/reduce-configure-check-time](https://github.com/LibreSign/libresign/tree/chore/reduce-configure-check-time)
-- Click the `Code` button and select the `Codespaces` tab.
-- Click **"Create codespace on feat/customize-signature-stamp"**
-
-### 2. Wait for the environment to start
-- A progress bar will appear on the left.  
-- After that, the terminal will show the build process.
-- Wait until you see the message:  
-  ```bash
-  ✍️ LibreSign is up!
-  ```
-  This may take a few minutes.
-
-### 3. Access LibreSign in the browser
-- Open the **Ports** tab (next to the **Terminal**).
-- Look for the service running on port **80**.
-- Hover over the URL and click the **globe icon** 🌐 to open it in your browser.
-
-### 4. (Optional) Make the service public
-- If you want to share the app with people **not logged in to GitHub**, you must change the port visibility:
-  - Click the three dots `⋮` on the row for port 80.
-  - Select `Change visibility` → `Public`.
-
-### 5. Login credentials
-- **Username**: `admin`  
-- **Password**: `admin`
-
-Done! 🎉
-You're now ready to test this.
-</details>
+- [ ] I have read and followed the [contribution guide](CONTRIBUTING.md).
+- [ ] ... (list your own tasks here)
+
+## AI (if applicable)
+
+- [ ] The content of this PR was partially or fully generated using AI