tighten docs prose and fix broken testing placeholder

- testing.md (+5 locales): replace [package_name] with Observer in prose, github.com/lbrty/observer/internal/ in import paths, and a real email in JSON fixtures
- introduction.md (+5 locales): merge self-hostable/self-hosted bullets
- getting-started.md (+5 locales): shrink "what you just started" to one sentence
- deployment.md (+5 locales): drop throat-clearing intro, tighten Docker lead
- DOCKER_HUB_README.md: minor fluff cuts

Author: sultaniman

DOCKER_HUB_README.md

@@ -128,7 +128,7 @@ The container entrypoint is the `observer` binary. Available sub-commands:
 
 ## File storage
 
-By default uploads are written to `STORAGE_PATH` inside the container. Mount a volume there to persist files across restarts.
+Uploads go to `STORAGE_PATH` inside the container. Mount a volume there to persist files across restarts.
 
 For production, set `STORAGE_BACKEND=s3` and supply `S3_BUCKET`, `S3_REGION`, and AWS credentials via the standard `AWS_*` environment variables. Any S3-compatible store (MinIO, Tigris, Cloudflare R2) works by setting `S3_ENDPOINT`.
 
@@ -137,7 +137,7 @@ For production, set `STORAGE_BACKEND=s3` and supply `S3_BUCKET`, `S3_REGION`, an
 ## Upgrading
 
 1. Pull the new image.
-2. Run `migrate up` — migrations are forward-only and safe to run on each deploy.
+2. Run `migrate up` — migrations are forward-only.
 3. Restart the service.
 
 ---

docs/content/docs/developers/testing.de.md

@@ -3,7 +3,7 @@ title: Testen
 weight: 4
 ---
 
-[package_name] verwendet drei Testschichten: Unit-Tests, Integrationstests mit Testcontainers und E2E-Tests über HTTP.
+Observer verwendet drei Testschichten: Unit-Tests, Integrationstests mit Testcontainers und E2E-Tests über HTTP.
 
 ```mermaid
 graph TD
@@ -121,7 +121,7 @@ Mocks werden aus Interfaces mit `go:generate`-Direktiven generiert.
 Die Direktive in `internal/user/repository.go`:
 
 ```go
-//go:generate mockgen -destination=mock/repository.go -package=mock [package_name]/internal/user UserRepository,CredentialsRepository,SessionRepository,MFARepository,VerificationTokenRepository
+//go:generate mockgen -destination=mock/repository.go -package=mock github.com/lbrty/observer/internal/user UserRepository,CredentialsRepository,SessionRepository,MFARepository,VerificationTokenRepository
 ```
 
 Führen Sie `just generate-mocks` aus, um alle Mocks nach Interface-Änderungen neu zu generieren.
@@ -141,9 +141,9 @@ import (
     "github.com/stretchr/testify/require"
     "go.uber.org/mock/gomock"
 
-    "[package_name]/internal/auth"
-    "[package_name]/internal/user"
-    mock_user "[package_name]/internal/user/mock"
+    "github.com/lbrty/observer/internal/auth"
+    "github.com/lbrty/observer/internal/user"
+    mock_user "github.com/lbrty/observer/internal/user/mock"
 )
 
 func TestRegisterUseCase_Execute(t *testing.T) {
@@ -311,7 +311,7 @@ import (
     "github.com/stretchr/testify/assert"
     "go.uber.org/mock/gomock"
 
-    mock_database "[package_name]/internal/database/mock"
+    mock_database "github.com/lbrty/observer/internal/database/mock"
 )
 
 func TestHealthEndpoint(t *testing.T) {
@@ -375,15 +375,15 @@ func TestAuthFlow_E2E(t *testing.T) {
     router := s.Router()
 
     // Schritt 1: Registrieren
-    regBody := `{"[package_name].kg","phone":"+49700111222","password":"MyStr0ngPass!","role":"user"}`
+    regBody := `{"email":"test@observer.kg","phone":"+49700111222","password":"MyStr0ngPass!","role":"user"}`
     w := httptest.NewRecorder()
     req := httptest.NewRequest(http.MethodPost, "/auth/register", strings.NewReader(regBody))
     req.Header.Set("Content-Type", "application/json")
     router.ServeHTTP(w, req)
     assert.Equal(t, http.StatusCreated, w.Code)
 
     // Schritt 2: Anmelden
-    loginBody := `{"[package_name].kg","password":"MyStr0ngPass!"}`
+    loginBody := `{"email":"test@observer.kg","password":"MyStr0ngPass!"}`
     w = httptest.NewRecorder()
     req = httptest.NewRequest(http.MethodPost, "/auth/login", strings.NewReader(loginBody))
     req.Header.Set("Content-Type", "application/json")

docs/content/docs/developers/testing.ky.md

@@ -3,7 +3,7 @@ title: Testtöö
 weight: 4
 ---
 
-[package_name] üç testtöö qatmaryn qoldonot: unit testter, testcontainers menen integrasijalyq testter cana HTTP arqylu E2E testter.
+Observer üç testtöö qatmaryn qoldonot: unit testter, testcontainers menen integrasijalyq testter cana HTTP arqylu E2E testter.
 
 ```mermaid
 graph TD
@@ -121,7 +121,7 @@ Mocktar interfejsterden `go:generate` direktivalary arqylu tüzülöt.
 `internal/user/repository.go` içindegi direktiva:
 
 ```go
-//go:generate mockgen -destination=mock/repository.go -package=mock [package_name]/internal/user UserRepository,CredentialsRepository,SessionRepository,MFARepository,VerificationTokenRepository
+//go:generate mockgen -destination=mock/repository.go -package=mock github.com/lbrty/observer/internal/user UserRepository,CredentialsRepository,SessionRepository,MFARepository,VerificationTokenRepository
 ```
 
 Interfejs özgörgöndön kiyin bardyq mocktardy qajra tüzüü üçün `just generate-mocks` işletiñiz.
@@ -141,9 +141,9 @@ import (
     "github.com/stretchr/testify/require"
     "go.uber.org/mock/gomock"
 
-    "[package_name]/internal/auth"
-    "[package_name]/internal/user"
-    mock_user "[package_name]/internal/user/mock"
+    "github.com/lbrty/observer/internal/auth"
+    "github.com/lbrty/observer/internal/user"
+    mock_user "github.com/lbrty/observer/internal/user/mock"
 )
 
 func TestRegisterUseCase_Execute(t *testing.T) {
@@ -311,7 +311,7 @@ import (
     "github.com/stretchr/testify/assert"
     "go.uber.org/mock/gomock"
 
-    mock_database "[package_name]/internal/database/mock"
+    mock_database "github.com/lbrty/observer/internal/database/mock"
 )
 
 func TestHealthEndpoint(t *testing.T) {
@@ -375,15 +375,15 @@ func TestAuthFlow_E2E(t *testing.T) {
     router := s.Router()
 
     // Step 1: Register
-    regBody := `{"[package_name].kg","phone":"+49700111222","password":"MyStr0ngPass!","role":"user"}`
+    regBody := `{"email":"test@observer.kg","phone":"+49700111222","password":"MyStr0ngPass!","role":"user"}`
     w := httptest.NewRecorder()
     req := httptest.NewRequest(http.MethodPost, "/auth/register", strings.NewReader(regBody))
     req.Header.Set("Content-Type", "application/json")
     router.ServeHTTP(w, req)
     assert.Equal(t, http.StatusCreated, w.Code)
 
     // Step 2: Login
-    loginBody := `{"[package_name].kg","password":"MyStr0ngPass!"}`
+    loginBody := `{"email":"test@observer.kg","password":"MyStr0ngPass!"}`
     w = httptest.NewRecorder()
     req = httptest.NewRequest(http.MethodPost, "/auth/login", strings.NewReader(loginBody))
     req.Header.Set("Content-Type", "application/json")

docs/content/docs/developers/testing.md

@@ -3,7 +3,7 @@ title: Testing
 weight: 4
 ---
 
-[package_name] uses three testing layers: unit tests, integration tests with testcontainers, and E2E tests via HTTP.
+Observer uses three testing layers: unit tests, integration tests with testcontainers, and E2E tests via HTTP.
 
 ```mermaid
 graph TD
@@ -121,7 +121,7 @@ Mocks are generated from interfaces using `go:generate` directives.
 The directive in `internal/user/repository.go`:
 
 ```go
-//go:generate mockgen -destination=mock/repository.go -package=mock [package_name]/internal/user UserRepository,CredentialsRepository,SessionRepository,MFARepository,VerificationTokenRepository
+//go:generate mockgen -destination=mock/repository.go -package=mock github.com/lbrty/observer/internal/user UserRepository,CredentialsRepository,SessionRepository,MFARepository,VerificationTokenRepository
 ```
 
 Run `just generate-mocks` to regenerate all mocks after interface changes.
@@ -141,9 +141,9 @@ import (
     "github.com/stretchr/testify/require"
     "go.uber.org/mock/gomock"
 
-    "[package_name]/internal/auth"
-    "[package_name]/internal/user"
-    mock_user "[package_name]/internal/user/mock"
+    "github.com/lbrty/observer/internal/auth"
+    "github.com/lbrty/observer/internal/user"
+    mock_user "github.com/lbrty/observer/internal/user/mock"
 )
 
 func TestRegisterUseCase_Execute(t *testing.T) {
@@ -311,7 +311,7 @@ import (
     "github.com/stretchr/testify/assert"
     "go.uber.org/mock/gomock"
 
-    mock_database "[package_name]/internal/database/mock"
+    mock_database "github.com/lbrty/observer/internal/database/mock"
 )
 
 func TestHealthEndpoint(t *testing.T) {
@@ -375,15 +375,15 @@ func TestAuthFlow_E2E(t *testing.T) {
     router := s.Router()
 
     // Step 1: Register
-    regBody := `{"[package_name].kg","phone":"+49700111222","password":"MyStr0ngPass!","role":"user"}`
+    regBody := `{"email":"test@observer.kg","phone":"+49700111222","password":"MyStr0ngPass!","role":"user"}`
     w := httptest.NewRecorder()
     req := httptest.NewRequest(http.MethodPost, "/auth/register", strings.NewReader(regBody))
     req.Header.Set("Content-Type", "application/json")
     router.ServeHTTP(w, req)
     assert.Equal(t, http.StatusCreated, w.Code)
 
     // Step 2: Login
-    loginBody := `{"[package_name].kg","password":"MyStr0ngPass!"}`
+    loginBody := `{"email":"test@observer.kg","password":"MyStr0ngPass!"}`
     w = httptest.NewRecorder()
     req = httptest.NewRequest(http.MethodPost, "/auth/login", strings.NewReader(loginBody))
     req.Header.Set("Content-Type", "application/json")

docs/content/docs/developers/testing.ru.md

@@ -3,7 +3,7 @@ title: Тестирование
 weight: 4
 ---
 
-[package_name] использует три уровня тестирования: модульные тесты, интеграционные тесты с testcontainers и E2E-тесты через HTTP.
+Observer использует три уровня тестирования: модульные тесты, интеграционные тесты с testcontainers и E2E-тесты через HTTP.
 
 ```mermaid
 graph TD
@@ -121,7 +121,7 @@ func TestUser_CanLogin(t *testing.T) {
 Директива в `internal/user/repository.go`:
 
 ```go
-//go:generate mockgen -destination=mock/repository.go -package=mock [package_name]/internal/user UserRepository,CredentialsRepository,SessionRepository,MFARepository,VerificationTokenRepository
+//go:generate mockgen -destination=mock/repository.go -package=mock github.com/lbrty/observer/internal/user UserRepository,CredentialsRepository,SessionRepository,MFARepository,VerificationTokenRepository
 ```
 
 Выполните `just generate-mocks` для перегенерации всех моков после изменения интерфейсов.
@@ -141,9 +141,9 @@ import (
     "github.com/stretchr/testify/require"
     "go.uber.org/mock/gomock"
 
-    "[package_name]/internal/auth"
-    "[package_name]/internal/user"
-    mock_user "[package_name]/internal/user/mock"
+    "github.com/lbrty/observer/internal/auth"
+    "github.com/lbrty/observer/internal/user"
+    mock_user "github.com/lbrty/observer/internal/user/mock"
 )
 
 func TestRegisterUseCase_Execute(t *testing.T) {
@@ -311,7 +311,7 @@ import (
     "github.com/stretchr/testify/assert"
     "go.uber.org/mock/gomock"
 
-    mock_database "[package_name]/internal/database/mock"
+    mock_database "github.com/lbrty/observer/internal/database/mock"
 )
 
 func TestHealthEndpoint(t *testing.T) {
@@ -375,15 +375,15 @@ func TestAuthFlow_E2E(t *testing.T) {
     router := s.Router()
 
     // Step 1: Register
-    regBody := `{"[package_name].kg","phone":"+49700111222","password":"MyStr0ngPass!","role":"user"}`
+    regBody := `{"email":"test@observer.kg","phone":"+49700111222","password":"MyStr0ngPass!","role":"user"}`
     w := httptest.NewRecorder()
     req := httptest.NewRequest(http.MethodPost, "/auth/register", strings.NewReader(regBody))
     req.Header.Set("Content-Type", "application/json")
     router.ServeHTTP(w, req)
     assert.Equal(t, http.StatusCreated, w.Code)
 
     // Step 2: Login
-    loginBody := `{"[package_name].kg","password":"MyStr0ngPass!"}`
+    loginBody := `{"email":"test@observer.kg","password":"MyStr0ngPass!"}`
     w = httptest.NewRecorder()
     req = httptest.NewRequest(http.MethodPost, "/auth/login", strings.NewReader(loginBody))
     req.Header.Set("Content-Type", "application/json")

docs/content/docs/developers/testing.tr.md

@@ -3,7 +3,7 @@ title: Test
 weight: 4
 ---
 
-[package_name] üç test katmanı kullanır: birim testleri, testcontainers ile entegrasyon testleri ve HTTP üzerinden uçtan uca testler.
+Observer üç test katmanı kullanır: birim testleri, testcontainers ile entegrasyon testleri ve HTTP üzerinden uçtan uca testler.
 
 ```mermaid
 graph TD
@@ -121,7 +121,7 @@ Mock'lar, `go:generate` direktifleri kullanılarak arayüzlerden oluşturulur.
 `internal/user/repository.go` dosyasındaki direktif:
 
 ```go
-//go:generate mockgen -destination=mock/repository.go -package=mock [package_name]/internal/user UserRepository,CredentialsRepository,SessionRepository,MFARepository,VerificationTokenRepository
+//go:generate mockgen -destination=mock/repository.go -package=mock github.com/lbrty/observer/internal/user UserRepository,CredentialsRepository,SessionRepository,MFARepository,VerificationTokenRepository
 ```
 
 Arayüz değişikliklerinden sonra tüm mock'ları yeniden oluşturmak için `just generate-mocks` komutunu çalıştırın.
@@ -141,9 +141,9 @@ import (
     "github.com/stretchr/testify/require"
     "go.uber.org/mock/gomock"
 
-    "[package_name]/internal/auth"
-    "[package_name]/internal/user"
-    mock_user "[package_name]/internal/user/mock"
+    "github.com/lbrty/observer/internal/auth"
+    "github.com/lbrty/observer/internal/user"
+    mock_user "github.com/lbrty/observer/internal/user/mock"
 )
 
 func TestRegisterUseCase_Execute(t *testing.T) {
@@ -311,7 +311,7 @@ import (
     "github.com/stretchr/testify/assert"
     "go.uber.org/mock/gomock"
 
-    mock_database "[package_name]/internal/database/mock"
+    mock_database "github.com/lbrty/observer/internal/database/mock"
 )
 
 func TestHealthEndpoint(t *testing.T) {
@@ -375,15 +375,15 @@ func TestAuthFlow_E2E(t *testing.T) {
     router := s.Router()
 
     // Step 1: Register
-    regBody := `{"[package_name].kg","phone":"+49700111222","password":"MyStr0ngPass!","role":"user"}`
+    regBody := `{"email":"test@observer.kg","phone":"+49700111222","password":"MyStr0ngPass!","role":"user"}`
     w := httptest.NewRecorder()
     req := httptest.NewRequest(http.MethodPost, "/auth/register", strings.NewReader(regBody))
     req.Header.Set("Content-Type", "application/json")
     router.ServeHTTP(w, req)
     assert.Equal(t, http.StatusCreated, w.Code)
 
     // Step 2: Login
-    loginBody := `{"[package_name].kg","password":"MyStr0ngPass!"}`
+    loginBody := `{"email":"test@observer.kg","password":"MyStr0ngPass!"}`
     w = httptest.NewRecorder()
     req = httptest.NewRequest(http.MethodPost, "/auth/login", strings.NewReader(loginBody))
     req.Header.Set("Content-Type", "application/json")

docs/content/docs/developers/testing.uk.md

@@ -3,7 +3,7 @@ title: Тестування
 weight: 4
 ---
 
-[package_name] використовує три рівні тестування: модульні тести, інтеграційні тести з testcontainers та E2E-тести через HTTP.
+Observer використовує три рівні тестування: модульні тести, інтеграційні тести з testcontainers та E2E-тести через HTTP.
 
 ```mermaid
 graph TD
@@ -121,7 +121,7 @@ func TestUser_CanLogin(t *testing.T) {
 Директива в `internal/user/repository.go`:
 
 ```go
-//go:generate mockgen -destination=mock/repository.go -package=mock [package_name]/internal/user UserRepository,CredentialsRepository,SessionRepository,MFARepository,VerificationTokenRepository
+//go:generate mockgen -destination=mock/repository.go -package=mock github.com/lbrty/observer/internal/user UserRepository,CredentialsRepository,SessionRepository,MFARepository,VerificationTokenRepository
 ```
 
 Виконайте `just generate-mocks` для перегенерації всіх моків після зміни інтерфейсів.
@@ -141,9 +141,9 @@ import (
     "github.com/stretchr/testify/require"
     "go.uber.org/mock/gomock"
 
-    "[package_name]/internal/auth"
-    "[package_name]/internal/user"
-    mock_user "[package_name]/internal/user/mock"
+    "github.com/lbrty/observer/internal/auth"
+    "github.com/lbrty/observer/internal/user"
+    mock_user "github.com/lbrty/observer/internal/user/mock"
 )
 
 func TestRegisterUseCase_Execute(t *testing.T) {
@@ -311,7 +311,7 @@ import (
     "github.com/stretchr/testify/assert"
     "go.uber.org/mock/gomock"
 
-    mock_database "[package_name]/internal/database/mock"
+    mock_database "github.com/lbrty/observer/internal/database/mock"
 )
 
 func TestHealthEndpoint(t *testing.T) {
@@ -375,15 +375,15 @@ func TestAuthFlow_E2E(t *testing.T) {
     router := s.Router()
 
     // Step 1: Register
-    regBody := `{"[package_name].kg","phone":"+49700111222","password":"MyStr0ngPass!","role":"user"}`
+    regBody := `{"email":"test@observer.kg","phone":"+49700111222","password":"MyStr0ngPass!","role":"user"}`
     w := httptest.NewRecorder()
     req := httptest.NewRequest(http.MethodPost, "/auth/register", strings.NewReader(regBody))
     req.Header.Set("Content-Type", "application/json")
     router.ServeHTTP(w, req)
     assert.Equal(t, http.StatusCreated, w.Code)
 
     // Step 2: Login
-    loginBody := `{"[package_name].kg","password":"MyStr0ngPass!"}`
+    loginBody := `{"email":"test@observer.kg","password":"MyStr0ngPass!"}`
     w = httptest.NewRecorder()
     req = httptest.NewRequest(http.MethodPost, "/auth/login", strings.NewReader(loginBody))
     req.Header.Set("Content-Type", "application/json")

docs/content/docs/guide/deployment.de.md

@@ -3,11 +3,9 @@ title: Bereitstellung
 weight: 5
 ---
 
-Diese Anleitung führt Sie durch die Installation von Observer auf einem Server, den Ihr Team nutzen kann. Sie brauchen kein tiefes technisches Wissen — wenn Sie sich per SSH auf einem Server einloggen und ein paar Befehle ausführen können, schaffen Sie das.
-
 ## Docker (empfohlen)
 
-Dies ist der einfachste Weg. Observer wird als einzelnes Docker-Image mit bereits integrierter Weboberfläche ausgeliefert — es muss nichts zusätzlich installiert oder auf der Frontend-Seite konfiguriert werden.
+Observer wird als einzelnes Docker-Image mit integrierter Weboberfläche ausgeliefert.
 
 ### Was Sie brauchen
 

docs/content/docs/guide/deployment.ky.md

@@ -3,11 +3,9 @@ title: Ornotuu
 weight: 5
 ---
 
-Bul qoldonmo Observerdi komandañyz qoldono ala turğan serverge ornottoonu cetektejt. Tereñ tehnikalyq bilim kerek emes — eger serverge SSH qylyp, biraz komanda iştete alsañyz, munu qyla alasyz.
-
 ## Docker (sunuştalat)
 
-Bul eñ ceñil col. Observer web interfejs menen dajyn bir Docker image katary kelet - frontend cağynan qoşumça ornotuu ce konfigurasija kerek emes.
+Observer web interfejs menen kelgen bir Docker image katary cönötülöt.
 
 ### Emne kerek