feat: enhance documentation and scripts for in-VM Git cloning and template setup

- Updated README.md to reflect the new in-VM git clone feature with `-UseGitClone`.
- Modified Setup-Host.ps1 to correct VMX path references.
- Revised various documentation files (ARCHITECTURE.md, CI-FLOW.md, HOST-SETUP.md, WINDOWS-TEMPLATE-SETUP.md) to include updated paths and features.
- Added Setup-GiteaSSH.md for SSH configuration instructions.
- Archived outdated documentation and updated README.md for clarity on current resources.
This commit is contained in:
Simone
2026-05-10 23:03:56 +02:00
parent a60f7a4b90
commit 90a4396443
12 changed files with 114 additions and 64 deletions
+18 -4
View File
@@ -4,9 +4,15 @@ Date: 2026-05-10
## Archived Files
### Setup-GiteaSSH.md
**Reason**: Obsolete — current workflow uses HTTP URLs + credential manager for Gitea access, not SSH key-based authentication.
**When to revisit**: If SSH-based Git clones become necessary (e.g., for server-to-server scenarios).
### PLAN.md (archived 2026-05-10)
**Reason**: Pianificazione iniziale (ultimo update 2026-05-08) superata dallo stato post Sprint 8.
Stato corrente del sistema, decisioni tecniche e roadmap sono ora distribuiti tra:
- `TODO.md` (root) per audit trail, summary status e backlog
- `docs/ARCHITECTURE.md` per il design del sistema
- `docs/CI-FLOW.md` per il flusso operativo
- `docs/RUNBOOK.md` per il triage incident
Resta come riferimento storico.
### TEST-7.4-e2e.md
**Reason**: Sprint 7.4 refactor validation document. Specific to §7.4 Deploy↔Setup refactor completion testing.
@@ -16,6 +22,13 @@ Date: 2026-05-10
- Post-refactor sign-off checklist
**Useful for**: §6.6 (Toolchain Tier-1) template updates, Linux template setup (§6.1)
## De-archived
### Setup-GiteaSSH.md (restored 2026-05-10)
Originariamente archiviato come "obsolete (HTTP+credential manager)" ma di fatto il workflow
live (`gitea/workflows/build-nsis.yml`) e `Setup-Host.ps1` continuano a usare l'alias SSH
`gitea-ci` (porta 2222) per i clone Git. Ripristinato in `docs/Setup-GiteaSSH.md`.
## Active Documentation
All current, operational docs remain in parent directory:
@@ -24,7 +37,8 @@ All current, operational docs remain in parent directory:
- CI-FLOW.md
- HOST-SETUP.md
- WINDOWS-TEMPLATE-SETUP.md
- LINUX-TEMPLATE-SETUP.md (draft for §6.1)
- OPTIMIZATION.md
- RUNBOOK.md
- TEST-PLAN-v1.3-to-HEAD.md
- LINUX-TEMPLATE-SETUP.md (draft for §6.1)
- Setup-GiteaSSH.md