# Material hezitzaile ireki bat sortzeko jarraibideak Jarraibide hauek «Vibe coding arduratsua» gidatik datoz, vibe coding bidez sortutako material hezitzaileak argitaratzeko (https://vibe-coding-educativo.github.io/vibe-responsable/eu/). Jarraitu itzazu lan osoan, sortu nahi dudan materialari buruz eskatzen dizudanarekin batera. Materiala modu irekian argitaratuko da, beste pertsona batzuek erabili eta egokitu ahal izan dezaten. ## Hasi aurretik Esan ez badizut, galdetu: - Agertu behar den egiletza (izen bat edo erabiltzaile-izen bat). - Non argitaratuko den: txatbot baten weban, aplikazioak sortzeko plataforma batean, edo biltegi batean edo norberaren gune batean. ## Nola eraiki behar den - Lizentzia: CC BY-SA 4.0 edukientzat eta AGPL v3 kodearentzat, beste batzuk adierazten ez badizkizut. - Txatbot baten weban lan egiten badugu, egin materiala nabigatzailean irekitzean berez funtzionatzen duen HTML orri gisa, eta ez txatbotaren barruan bakarrik funtzionatzen duen osagai gisa. - Liburutegiak, tipografiak eta kanpoko beste baliabide batzuk erabil ditzakezu lana aurrezten badute edo emaitza hobetzen badute. Kargatu itzazu zerbitzu ezagun eta egonkor batetik, eta jaso itzazu erabakien oharrean, haien lizentziarekin. Materialaren zerbaitek funtzionatzeari utziko balio interneterik gabeko ordenagailu batean deskargatuta irekitzean, esan iezadazu hitz errazekin, adibidez: «interneterik gabe irekitzen baduzu, formulak ez dira ikusiko». - Datu pertsonalak: ez eskatu izena ezta pertsona bat identifikatzen duen daturik ere, salbu eta tresnak bere funtziorako behar badu, notak jasotzeko koaderno batek adibidez. Kasu horretan, gorde gailuan bakarrik eta eskaini izenik gabe esportatzeko edo inprimatzeko aukera. Programak ikasleen erantzunak biltzen baditu, erakutsi emaitza amaitzean edo utzi deskargatzen entregatzeko, eta identifikatu pertsona bakoitza kode batekin, izenaren ordez. Ez bidali ezer inongo zerbitzarira, eta ez gehitu analitikarik ezta bisita-kontagailurik ere. - Irisgarria, Web Edukiaren Irisgarritasun Jarraibideei (WCAG) jarraituz: teklatuarekin bakarrik erabiltzeko modukoa, tabulazio-ordena logikoarekin, kontroletan etiketekin, irudietan testu alternatiboekin, kontraste nahikoarekin, ezer ulertzeko kolorearen mende egon gabe eta mugikor baten pantailan irakurtzeko modukoa. - Kode irakurgarria eta materialaren hizkuntzan iruzkindua, trinkotu gabe, aldagai-izen ulergarriekin. - Materialaren oinean: izenburua, egiletza, lizentzia bere estekarekin eta IAren erabilerari buruzko adierazpen labur bat, tresnarekin, hilabetearekin eta urtearekin, eta nik egiaztatu dudanarekin (galdetu argitaratu aurretik). - Beste pertsona batzuen irudiak, soinuak edo kode-zatiak gehitzen badituzu, erabili berrerabiltzea ahalbidetzen duen lizentzia duen materiala bakarrik, eta adierazi haren egiletza, jatorria eta lizentzia materialaren barruan bertan. - Programak ikasleen datuak ikastetxeko sistemetan gordeko baditu, ez idatzi gakorik edo pasahitzik nabigatzailera iristen den kodean, egin ezazu bildutakoa irakasleak edo ikastetxeak bakarrik irakurri ahal izatea, eta adierazi iezadazu ezagutza teknikoak dituen pertsona batek zer berrikusi behar duen erabiltzen hasi aurretik. - Aldaketa bakoitzaren ondoren, egiaztatu berriro lehendik ondo zebilena: exekutatu probak baldin badaude edo, ezin baduzu, esan iezadazu zer egiaztapen errepikatu behar ditudan. ## Biltegi batean edo norberaren gune batean argitaratzen bada - Gehitu LICENSE fitxategi bat kodearen lizentziarekin eta beste bat edukienarekin, eta adierazi lizentzia kode-fitxategi bakoitzaren hasieran SPDX-License-Identifier lerro batekin. - Gehitu proiektua nola antolatuta dagoen eta fitxategi bakoitza zertarako den azaltzen duen dokumentu bat. - Eraman erabakien erregistro bat (ADR) proiektuaren barruan, erabaki bakoitzeko fitxategi batekin, testuingurua, baztertutako aukerak eta ondorioak jasoz. Jaso bertan hartzen dugun erabaki bakoitza, nik eskatu arte itxaron gabe. Erabaki teknikoetan, jaso zertan oinarritzen zaren ere (dokumentazio ofiziala, kodearen bertsio zehatz bat edo errepika daitekeen proba bat), arrisku ezagunak eta nola egiaztatu duzun. Ez asmatu iturririk ezta probarik ere: egiaztatu ezin izan duzuna, markatu baliozkotzeko dagoen hipotesi gisa. - Berrikusi irisgarritasuna tresna automatiko batekin eta zuzendu detektatzen duena. - Bertsio bat argitaratzen dugunean, markatu bertsio-etiketa batekin (v1.0, v1.1…) eta ez mugitu edo berrerabili gero argitaratutako etiketa bat. ## Materiala amaitzen duzunean - Deskribatu laburki materialak zer egiten duen, zer gordetzen duen eta kanpoko zerbitzuren batekin komunikatzen den. - Prestatu egiaztapen-zerrenda labur bat ibilbide nagusiekin eta muturreko kasuekin, aldaketa bakoitzaren ondoren errepikatzeko. Proiektuak ahalbidetzen badu, bihurtu proba automatiko. - Idatzi ohar labur bat hartu dituzun erabaki garrantzitsuekin eta bakoitzaren arrazoiarekin, edo laburbildu erabakien erregistrotik, baldin badago. - Adierazi zer egiaztatu behar dudan nik, edukien zuzentasunetik hasita.