MIRRI Pracovná skupina K9.5 Lepšie služby - Dizajn manuál

podla mna by stacilo si precitat a preklikat co publikujete. Uz v readme.md su nekorektne informacie. Napriklad link na generovane CSS a JS su do IDSKv2 a nie IDSKV3, co by som ocakaval. Ale vo verzii IDSKv3 v DIST je nejaky govuk.xxxx.css a JS. Pritom by stacilo to nechat prazdne, ked uz to neviete publikovat aktualne a do readme.md napisat postup ako si vygenerovat CSS JS subory.

Ocakaval by som radsej menej publikovanych informacii, ale hlavne nech su platne a nie rozne nezmysly. To vytvara iba zbytocny chaos. Staci sa pozriet na priklady, ktore su stare SKIT ukazky, ktore su casto v rozpore aj z pristupnostou (udajne je k nim viacej ako 300 pripomienok). Denne musime riesit a vysvetlovat tieto “uzasne informacie” aj zakaznikom, ktory este k tomu dostanu email od Mirri kde v odpovedi a v 4 bodoch si navzajom odporuju niekolkokrat. :rofl:

Ahoj,

S automatizaciou okolo GitHub (actions) a popripade distribuciou viem helfnut. Viete ako to chcete releasovat? Tagom alebo nejak inac?

Co sa tyka NPM, chcete to davat na oficialne npmjs.com? Tam staci vytvorit nejaky ucet/organizaciu cez ktoru sa to tam potom bude tlacit. Ma to potom krajsi npm install ako github packages :slight_smile:

Co sa tyka potom CSSiek… chcete to pushovat aj na nejake CDN? Ci to uz nechate na ludi a vy im len vypublikujete CSSka na download?

podla mna by stacilo si precitat a preklikat co publikujete. Uz v readme.md su nekorektne informacie. Napriklad link na generovane CSS a JS su do IDSKv2 a nie IDSKV3, co by som ocakaval. Ale vo verzii IDSKv3 v DIST je nejaky govuk.xxxx.css a JS. Pritom by stacilo to nechat prazdne, ked uz to neviete publikovat aktualne a do readme.md napisat postup ako si vygenerovat CSS JS subory.

Presne o tom je príspevok, na ktorý reagujete. Hľadáme niekoho, kto nám pomôže s týmito balíkmi a následne upravíme návody na všetkých miestach. Tieto návody vznikli ako kópia z ID-SK2 a priebežne ich aktualizujeme.
Ak by sme tie návody úplne stiahli, tak výsledok by bol rovnaký (dodávatelia by nevedeli, alebo len veľmi ťažko vedeli importnúť IDSK3 do svojich projektov), akurát by sa zmenili otázky z “kde sú/ kedy budú balíky?” na “ako máme rozbehať ID-SK na projekte?”

Ocakaval by som radsej menej publikovanych informacii, ale hlavne nech su platne a nie rozne nezmysly. To vytvara iba zbytocny chaos.

Uvedomujeme si, že situácia stále nie je dobrá (dôvod viď. história tohto vlákna) a pravidelne nachádzame nedostatky, ktoré vznikli pri tvorbe IDSK3. Postupne ich odstraňujeme. Narážame na kapacitné možnosti tímu a množstvo agendy, takže niektoré veci trvajú výrazne dlhšie ako by v ideálnom svete mali.

Staci sa pozriet na priklady, ktore su stare SKIT ukazky, ktore su casto v rozpore aj z pristupnostou (udajne je k nim viacej ako 300 pripomienok)

Pripomienok je cca. 250 (130 k prístupnosti, 110 ostatné témy - dizajn, dokumentácia, web a pod.). Veľké množstvo pripomienok sme už zapracovali (hlavne prístupnosť, zladenie s vyhláškou). Je tam ale kopec úloh, ktoré si vyžadujú veľkú prácnosť, alebo dokonca úpravu legislatívy (príloha 12). Totiž “staré ukážky SKIT” majú množstvo zdrojov a verzií, ktoré ale nie sú konzistentné medzi sebou. My to musíme upratať a určiť jednu cestu, ktorou sa pôjde.

Denne musime riesit a vysvetlovat tieto “uzasne informacie” aj zakaznikom, ktory este k tomu dostanu email od Mirri kde v odpovedi a v 4 bodoch si navzajom odporuju niekolkokrat. :rofl:

Ak vás môžem poprosiť ten mail preposlať, buď do dm, alebo na mail: tomas.makan@mirri.gov.sk, aby sme si mohli zanalyzovať, ktoré odpovede neboli správne a zapracovať do komunikácie a dokumentácie.

1 Like

Viete ako to chcete releasovat? Tagom alebo nejak inac?

Klasicky Tagom, nechceme vymýšľať nejaké vlastné procesy.

Co sa tyka NPM, chcete to davat na oficialne npmjs.com ? Tam staci vytvorit nejaky ucet/organizaciu cez ktoru sa to tam potom bude tlacit. Ma to potom krajsi npm install ako github packages :slight_smile:

Áno tak, úplne stačí NPM (v podstate rovnako to bolo aj pre ID-SK2). Účty tam boli kedysi vytvorené, riešime akurát prístup.

Co sa tyka potom CSSiek… chcete to pushovat aj na nejake CDN? Ci to uz nechate na ludi a vy im len vypublikujete CSSka na download?

V prvom kole asi stačí keď to vypublikujeme na stiahnutie. Priznám sa s CDN nemám skúsenosti, ale ak to má zmysel, tak v druhom kole spravíme a medzitým si dáme vysvetliť výhody/nevýhody tohto prístupu.

ID-SK2 to má spravené a popísané takto: ID-SK Frontend - Ako začať s vývojom a z toho NPM časť @id-sk/frontend - npm
Vôbec neviem odhadnúť prácnosť a náročnosť týchto vecí.

2 Likes

Ahojte, klúče od @id-sk/frontend - npm mám ja. Písal som Tomášovi email…

CDN v dobe cache partioningu nema ziadne vyhody pre navstevnikov webov.

Tak jedine, ze by to bolo take ozajstne geo-aware CDN, co vie usetrit zopar milisekund.

Nechcete nic nestandardne. Co je dobre. Cize moj odhad: pre niekoho kto trochu pozna GitHub actions, ma poriesene pristupy atd… to moze byt tak 1 MD podla problemov :-).

Ten package.json vyzera chodivo.

Takze…Toto je len tak z hlavy…

Ta GH action moze byt velmi jednoducha, Do .github/workflows/ strcit nieco ako release.yaml:

name: Release the IDSK3
on:  
  push:  
    tags:  
      - 'v[0-9]+.[0-9]+.[0-9]+'

jobs:
  release:
    runs-on: ubuntu-latest
    steps:    
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
       - name: build CSS
         run: ... something that will create tar.gz with css ...
       - name: Release
         uses: softprops/action-gh-release@v2
         with:
           files: |
              ./path/to/css-archive.tar.gz

  publish-to-npm:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      id-token: write
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20.x'
          registry-url: 'https://registry.npmjs.org'
      - run: npm ci
      - run: npm publish --provenance --access public
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

Samozrejme na npmjs treba vytvorit token a nastavit ho ako secret NPM_TOKEN. Vsimol som si ze je tam .npmrc (idsk3-frontend/.nvmrc at main · id-sk/idsk3-frontend · GitHub) a ten asi bude prepisany tym setup-node. Tak podla dolezitosti jeho obsahu.

A co este take? Na zaciatok asi staci.

… samozrejme da sa to vysperkovat podla potreby

Mám teda odpovedať na obsah správy, alebo nie?

Skupina necakane ozila cez prazdniny.

Vážené členky a vážení členovia Pracovnej skupiny Lepšie služby,

V prílohe vám posielame konsolidované znenie návrhu úpravy prílohy č. 12 Vyhlášky o štandardoch (aj s vyznačením revízie zmien), v ktorej je upravený jednotný dizajnový manuál verejnej správy (IDSK).

Aktuálna právna úprava obsahuje nedostatky v názvosloví a pomenovaní komponentov, stavov a ich vlastností.

Cieľom navrhovaných úprav je predovšetkým zjednotiť znenie ustanovení prílohy č. 12, ich spresnenie, prípadne odstránenie častí, ktoré sú z pohľadu vývoja informačných technológií zastaralými, akými je napríklad obmedzenie funkčnosti bez použitia technológie JavaScript.

Zároveň v prílohe posielame aj návrh Metodického usmernenia Ministerstva investícií, regionálneho rozvoja a informatizácie Slovenskej republiky zo dňa xx. xx. 2025 č. xxxxxx/2025/OKPSPI k tvorbe nového a úprave existujúceho komponentu dizajnového manuálu orgánmi riadenia.

Uvedené dokumenty vypracovali kolegovia z oddelenia kvality používateľskej skúsenosti a prístupnosti ITVS / SITVS MIRRI SR a budú ich prezentovať a schvaľovať na štandardizačnej pracovnej skupine dňa 19.08.2025.

Príloha č. 12.docx (56.2 KB)
MU_nových komponentov - úprava existujúcich - verzia 2025_na PS.docx (405.3 KB)
bod 2_Príloha č. 12_revízia.docx (2.0 MB)

Pripomienky vitane…

otazocka ohladne resposivity:
podla popisu k textom budu dva break points. Do 730px a nad 730px. Nie je to malo? Dufam, ze riesime responsivitu a nie nieco ako desktop, mobile … podobne zastarale myslenia. Aj na pocitaci si mozem predsa stiahnut okno na uzke a podla toho sa mi to presklada, co je v podstate pohlad na malom device kde sice mozem mat sirku view portu 1920px, ale pri pixel ration 2 je to uz iba 1920/2=960 alebo pri pixel ration 3 je to 1920/3=640. Preto mi to pride malo mat iba 2 BP. Ja navrhujem pridat este jeden mensi kvoli device ako su pocitace.
Ak hovorime o responsivite a nie skatulkovanie na mobile, desktop, atd.

Pri popise komponentov by mali byt aj popisane alternativy pre jednotlive BPs. Napr. tabulka je taky typicky komponent. Tabulka sa moze preskladat z horizontalnej na vertikalnu (niekdy postaci iba CSS) aj mam uz viacej stlpcov a na maly BP sa nezmestim. Supanie tabulky zlava do lava kedy nevidim v skutocnosti takmer nic mi nepride velmi pristupne.
Ale takychto komponentov moze byt ovela viacej a mozu byt “zlozitejsie”.

Ak uvadzate sirky obrazovky 730px tak by sa malo uviest o aky pixel sa jedna lebo v tomto pripade sa asi bude jednat o virtualny pixel.

Preco vlastne menime break points, ktore boli v IDSK2? Bude k tomu aj nejake CSS alebo si to budeme robit na kolene podla prilohy c. 12? Ak ano tak to bude zaujimave

.

1 Like

Takže z tohto dôvodu nefunguje idsk.gov.sk ?

1 Like

Prešiel som si dokumenty.
Metodika k spolupráci:
Táto sa začala tvoriť niekedy v 2021, 2022 to umrelo a bolo dlho dlho ticho (zmena priorít, koniec projektu BRISK, personálne zmeny…)
Otvorili sme to pred koncom roka 2024 keď sa podarilo vyriešiť najkritickejšie problémy s IDSK3.
Keď som vtedy robil research dostupné DS vs IDSK, tak IDSK bolo strašne komplikovaný proces, byrokracia…
Odkedy sme sa tomu venovali, hovorili sme o jednoduchých procesoch (daj nám to pozrieť na začiatku, potom to spolu otestujeme a hotovo). Mali sme spísanú kostru aj pre takéto “odvážne” riešenie.

Som rád, že tím postupne doiteroval k takejto jednoduchej verzii (tu sú základné princípy informatizácie /itvs alebo gov.uk/ napasované na komponenty; tú sú technické pravidlá IDSK /na webe/; povedz nám čo chceš spraviť a potom nám ukaz ako to funguje.)

Tiež sa mi páči možnosť zaradiť takýto komponent do IDSK. Umožní to oveľa rýchlejšiu prácu na Core knižnici a zároveň tvorbu komunitných zdrojov.

Revízia Príloha 12
Primárne sa riešili 3 problémy:

  1. Gramaticko-stylisticke úpravy
  2. Zjednotenie pojmov (toto robilo strašné bolehlavy) - stavy vs akcie, farby lietali, verzie lietali
  3. Zjednotenie s dokumentáciou - veľa veci bolo inak v prílohe ako text vs obrázok, v dokumentácii atď.

V podstate nič nové sa nespravilo, len sa to upratalo tak ako to malo byť už v 2023. Čo je super a vyrieši to interné veľa otázok. Opakovali sa od momentu kedy sme to chytili do rúk.

Ešte tam vidím pár vecí, ktoré ušli, ale na to je IPK, MPK, PS atď. :slight_smile:

Pochvala patrí IDSK a OKPSps tímu, že to posúvajú v rámci možností :pray:

1 Like

Breapointy sú inšpirované gov.uk, tiež majú dve - veľká obrazovka, malá.

Tieto veci patria primárne do dokumentácie (dizajn, dev). Nie do vyhlášky. Tu súhlasím s prístupom SKITu, lebo meniť vyhlášku a prílohu je proces na pol roka.

Ževraj sa niečo nasadzovalo koncom týždňa a boli tam chyby. Rieši sa to.

2 Likes

… som si tak minule vravel, že kedy toto napadne šikovným Slováčiskom … a stalo sa, máme tu prvý scam využívajúci ID-SK

2 Likes

Vsetci vieme, ze design manual je potrebny v kombinacii s prechodom na “povinnu” *.gov.sk domenu. Snad toto bude motivacia (opat raz)

1 Like

A ešte to ani nie je úplne podľa IDSK. Ja by som ich za to pokutoval.

TLD “lol”!

Dobrý deň/Ahojte,
zaujímalo by ma, či existuje nejaký zoznam štátnych webov, ktoré sú v súlade s IDSK (aktuálne s IDSK3)? Ďakujem

1 Like

Všetky. Snáď dodržiavame zákony… :winking_face_with_tongue:

2 Likes