initial commit

Change-Id: Ied1b5f2137f2b5f803d5411235607bd27c5e57ba

docs/api.md

@@ -0,0 +1,19 @@
+# API Reference
+
+Base URL: `https://tmpl-test-go.kyndemo.live`
+
+## Items `/api/items`
+
+| Method | Path | Body | Response |
+|--------|------|------|----------|
+| GET | `/api/items` | — | Array of items |
+| POST | `/api/items` | `{"name":"...","description":"..."}` | Created item (201) |
+| GET | `/api/items/{id}` | — | Item or 404 |
+| PUT | `/api/items/{id}` | `{"name":"...","description":"..."}` | Updated item |
+| DELETE | `/api/items/{id}` | — | `{"deleted":id}` |
+
+## Observability
+| Path | Description |
+|------|-------------|
+| `/health` | `{"status":"UP"}` |
+| `/metrics` | Prometheus exposition format |

docs/architecture.md

@@ -0,0 +1,17 @@
+# Architecture
+
+`tmpl-test-go` is a Go 1.22 service using only the standard `net/http` library.
+
+| Component | Technology |
+|-----------|-----------|
+| HTTP | stdlib `net/http` |
+| Metrics | `prometheus/client_golang` → `/metrics` |
+| Health | `/health` |
+| Image | Distroless `nonroot` (minimal attack surface) |
+
+## Deployment flow
+
+```
+Push → build-push.yml (go test + docker build → ACR)
+     → deploy-humanitec.yml (humctl score deploy)
+```

docs/index.md

@@ -0,0 +1,7 @@
+# Home
+
+tmpl-test-go — Test scaffold for go runtime
+
+- **Runtime**: Go 1.22 · stdlib `net/http`
+- **Owner**: platform-engineering
+- **Deployment profile**: `stateless`