IArekin sortzeko jarraibideak

Nola erabiltzen diren

Gidaren gomendioak zuzenean eman dakizkioke adimen artifizialari (IA), haiek betetzeko lana pertsonaren gain eror ez dadin. Horretarako jarraibide-fitxategi bat dago, edozein tresnatan deskargatu eta erabil daitekeena. Gidak eskatzen duena bakarrik du; materialak zer egin behar duen bereiz deskribatzen da, beti bezala.

Fitxategia hastean ematen da:

Txatbot baten weban, lehen mezuari eransten zaio, sortu nahi den materialaren deskribapenarekin eta «jarraitu erantsitako fitxategiko jarraibideak» adierazpenarekin batera.
Programazio-agente batean edo IA duen kode-editore batean, proiektuaren karpetan gordetzen da jarraibide-fitxategi gisa, eta IAk saio guztietan hartzen du kontuan.
Aplikazioak sortzeko plataformetan, proiektuaren jarraibide iraunkorretan itsasten da; plataforma askok ezarpenetan edo proiektuko fitxategi gisa eskaintzen dituzte.

IAk ez badaki egiletza edo materiala non argitaratuko den, jarraibideek berek eskatzen diote hasi aurretik galde dezala. Amaitzean, komeni da elkarrizketa berean VCER ebaluazioa eskatzea, falta dena adierazten duena. Berrikuspen horrek ez du pertsonarena ordezten, ereduak ere huts egiten baitu bere lana berrikustean.

Material bat sortzeko

Hau da material bat sortzen hastean IAri ematen zaion fitxategia. Deskarga daiteke eransteko edo proiektuaren karpetan gordetzeko, edo bere testua kopiatu elkarrizketaren hasieran itsasteko.

Fitxategia deskargatu

Sortzeko jarraibideak ikusi

# 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.