Zašto GitHub

Tražite vodič za sudjelovanje u reviziji? → Vodič za reviziju

Tražite upute za email obavijesti? → Email obavijesti

Što je GitHub?

GitHub je besplatna platforma za suradnju na dokumentima i kodu. Koriste ga milijuni programera, tvrtki i organizacija diljem svijeta — uključujući Europsku komisiju za EN16931 specifikacije.

Ovaj projekt koristi GitHub jer:

• Besplatan je — za javne projekte nema nikakvih troškova, ni za održavatelje ni za suradnike
• Transparentan — svaka promjena je vidljiva, s autorom, datumom i obrazloženjem
• Otvoren — svatko može čitati dokumentaciju bez registracije
• Verzioniran — svaka izmjena je trajno sačuvana, moguće je vidjeti povijest i vratiti se na stariju verziju
• Omogućuje strukturiranu suradnju — Issues, Pull Requests, rasprave, glasanje
• GitHub Pages — automatski generira web stranicu iz dokumentacije

Koliko košta?

Ništa. GitHub je besplatan za javne projekte. Čitanje dokumentacije, pregled povijesti izmjena i pristup web stranici ne zahtijeva ni registraciju.

Za aktivno sudjelovanje (komentare, rasprave, prijedloge) potrebna je besplatna registracija — traje 2 minute na github.com.

Tko još koristi GitHub za zakone, propise i dokumentaciju?

GitHub nije samo za programere — koriste ga državne institucije, porezne uprave i zakonodavci diljem svijeta za otvorenu suradnju na propisima i dokumentaciji.

Europska unija

Porezne uprave

Zakonodavci

Velike tvrtke

Poanta: Ako Microsoft koristi GitHub za svu svoju dokumentaciju, njemački KoSIT za XRechnung specifikacije, američka IRS za porezne zakone, a Europska komisija za EN16931 — onda je GitHub apsolutno prikladno mjesto za zajedničku dokumentaciju o hrvatskim eRačunima.

Kako čitati ovu dokumentaciju?

Na web stranici (najjednostavnije)

Otvorite dageci.github.io/eracun-fiskalizacija-datumi — formatirani prikaz s dijagramima, tablicama i navigacijom. Ne treba registracija.

Na GitHubu

Otvorite github.com/dageci/eracun-fiskalizacija-datumi — GitHub automatski prikazuje Markdown datoteke s formatiranjem i Mermaid dijagramima. Ne treba registracija.

Kako sudjelovati?

Za kompletne upute o sudjelovanju u reviziji pogledajte Vodič za reviziju. Tamo je objašnjeno:

• Kako pronaći segment dokumentacije koji vas zanima
• Kako ostaviti komentar ili potvrdu ispravnosti
• Kako predložiti izmjenu kroz Pull Request
• Kako sudjelovati u radnim sastancima
• Sva Kanban stanja i što znače

Za praćenje napretka revizije: Napredak revizije.

Ako samo želite čitati dokumentaciju, ne trebate ništa — otvorite web stranicu i čitajte.

Tko može sudjelovati?

Svi koji rade s hrvatskim eRačunima:

• ERP programeri — koji implementiraju kreiranje eRačun XML-a
• Knjigovođe — koji moraju razumjeti kako datumi utječu na PDV
• Informacijski posrednici — koji procesiraju eRačune (MER, PONDI, FINA)
• Porezni savjetnici — koji poznaju zakonski okvir
• Predstavnici Porezne uprave — koji mogu službeno potvrditi tumačenja
• Studenti — koji uče o e-fakturiranju

GitHub pojmovi na hrvatskom

Ako vam je GitHub sučelje na engleskom, evo što znače ključni pojmovi:

Što je Markdown?

Dokumentacija je napisana u Markdown formatu — jednostavan tekstualni format koji GitHub automatski prikazuje s formatiranjem (naslovi, tablice, linkovi, code blokovi). Ne trebate nikakav poseban softver — možete editirati u bilo kojem text editoru.

Primjer:

## Naslov sekcije {#sec-naslov-sekcije}

**Bold tekst** i *kurzivni tekst*

- Stavka liste
- Druga stavka

| Stupac 1 | Stupac 2 |
|----------|----------|
| Redak 1  | Podatak  |

Što su Mermaid dijagrami?

Dokumentacija koristi Mermaid dijagrame za vizualizaciju workflow-a i procesa. GitHub ih automatski renderira iz tekstualnog opisa — nema potrebe za crtanjem u grafičkom alatu.

Primjer:

```mermaid
flowchart LR
  A[BT-2 IssueDate] --> B{BT-7 prisutan?}
  B -->|Da| C[PDV po BT-7]
  B -->|Ne| D[PDV po BT-2]
```

Licenca

Projekt koristi EUPL 1.2 licencu — slobodno koristite, dijelite i prilagođavajte uz:

• Navođenje autora
• Dijeljenje pod istim uvjetima

Puni tekst: joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12

Imate pitanje o korištenju GitHuba za ovaj projekt? Otvorite Discussion — rado ćemo pomoći.