Link to bitbucket repository [https://bitbucket.org/systemthinking-in-it/repo_sthdf_2024-2025/wiki/Home](https://bitbucket.org/systemthinking-in-it/repo_sthdf_2024-2025/wiki/Home} https://bitbucket.org/systemthinking-in-it/repo_sthdf_2024-2025/wiki/Projects-2024-2025.md We are moving our ecosystem to GitHUB.
Tento projekt slúži ako praktická ukážka rôznych spôsobov dokumentovania a publikovania výstupov z Git repozitára.
Môžeš si pozrieť a porovnať rôzne prístupy – každý je umiestnený v samostatnej vetve (branch).
| Typ dokumentácie | Vetva | Popis | Link (ak nasadený) |
|---|---|---|---|
| 📝 GitHub Pages | pages-only |
Klasické GitHub Pages z jednoduchého HTML/MD | Zobraziť |
| 📚 MkDocs | mkdocs |
Dokumentácia pomocou MkDocs a Material tému | Zobraziť |
| 🔀 Kombinované (Mix) | mix |
README + MkDocs + (voliteľne) Wiki | Zobraziť |
| Krok | Stav | Poznámka |
|---|---|---|
| 🔁 Klon Bitbucket Wiki | 🔄 prebieha | git clone https://bitbucket.org/...wiki.git |
| 🌐 Migrácia do GitHub Pages | 🔲 čaká | Vetva pages-only |
| 📦 Migrácia do MkDocs | 🔲 čaká | Vetva mkdocs, štruktúra docs/ |
| ⚙️ CI/CD pre MkDocs | 🔲 čaká | GitHub Action v .github/workflows/ |
| 🎯 Výsledné zverejnenie | 🔲 čaká | Na gh-pages vetve automaticky |
Každý prístup má svoje výhody a úskalia – odporúčam si ich prejsť, forknúť repozitár a upraviť podľa potreby.
Tento repozitár slúži ako „živá učebnica“ digitálnej dokumentácie v GitHub prostredí.
Autor: Roman Kazička
Repozitár: repo_sthdf-2024-2025