Si shtohet ose azhurohet një faqe

Help-i është një projekt VitePress. Çdo faqe është një skedar Markdown në dosjen docs/, dhe emri i skedarit është key i formës.

docs/
  .vitepress/forms.json     ← lista e moduleve, seksioneve dhe formave (meny anësore)
  sales/s-inv.md            ← faqja për /admin/sales/s-inv
  sales/offer.md            ← …
  public/img/sales/…        ← screenshot-et
  udhezime/                 ← udhëzimet e përgjithshme

Shtimi i një forme të re

1. Shtoni formën te docs/.vitepress/forms.json, te moduli dhe seksioni përkatës:

   { "title": "Faturat e shitjes", "key": "sales/s-inv" }

2. Ekzekutoni npm run gen. Krijohet docs/sales/s-inv.md me shabllonin draft.
3. Plotësoni faqen dhe ndryshoni status: draft në status: gati, me tested: 2026-09-30.

Struktura e një faqeje forme

---
title: Faturat e shitjes
key: sales/s-inv          # rruga e formës pas /admin/
status: gati              # gati | draft | vjeter
tested: 2026-09-30        # data kur u testua forma për këtë udhëzim
---

# Faturat e shitjes

## Për çka shërben
## Hapat
## Fushat
## Shënime dhe gabime të shpeshta

Screenshot-et vendosen te docs/public/img/<moduli>/ dhe shtohen kështu:

<img class="shot" src="/img/sales/s-inv-lista.png" alt="Lista e faturave">

Azhurimi me Cowork

Procesi që përdorim për çdo formë:

1. Cowork hap formën në web.finabit.com, e teston (krijim, ndryshim, validime) dhe merr screenshot-e.
2. Shkruan ose azhuron faqen docs/<key>.md dhe vendos status: gati dhe datën tested.
3. Gabimet që gjen gjatë testimit i regjistron në Linear (projekti Finabit Web), jo në help.
4. Ndryshimet dërgohen në GitHub. Cloudflare Pages e publikon help-in automatikisht pas çdo commit-i.

Kur ndryshon një formë në web, vendosni status: vjeter te faqja derisa të ritestohet.

Komandat

npm install        # herën e parë
npm run dev        # help-i lokalisht në http://localhost:5173
npm run build      # gjeneron faqet dhe ndërton sajtin në docs/.vitepress/dist