Uoffisielt supporterprosjekt · under oppbygging
AaFK-arkivet

Åpent arkiv

Hva vil du bidra med?

Velg det som passer. Minner kan sendes uten konto. Rettelser og nye data bruker korte GitHub-skjema, slik at vi får opplysningene som trengs første gang.

Raskest

Del et minne

Finn kampen eller sesongen og trykk «Bidra». Skjemaet kjenner allerede stedet og kan sendes uten innlogging.

Finn kampen
Rett sted med én gang

Rett eller legg til data

Velg et ferdig skjema. GitHub-konto kreves, men du slipper å kjenne arkivets filformat eller vite hvor rettelsen hører hjemme.

Hva som skjer etterpå

Ingenting går rett i arkivet. Minner havner i en egen innboks. Feil og nye data blir GitHub-saker med riktig mal. Begge deler blir kontrollert før noe publiseres.

Et godkjent minne vises under «Observasjoner og minner», merket med hvor sikkert det er. En datarettelse endrer i stedet den aktuelle kampen eller kilden, med et synlig spor i git.

Et godt bidrag inneholder

Ikke kopier kampreferat. Send lenken til originalen. Opphavsrettsbeskyttet tekst skal ikke inn i arkivet.
Vil du gjøre en større datajobb med AI?

Bruk AI-en du allerede har

Du trenger ikke kunne YAML for å bidra. Kopier en av promptene under inn i modellen du bruker til vanlig, fyll inn det du vet om kampen, og la den skrive filen. Da holder det at du har kildene og kontrollerer resultatet.

Promptene forteller modellen hvordan arkivet er bygget opp, og — viktigere — hva den ikke skal gjøre: gjette på fakta den ikke finner, og kopiere eller omskrive referattekst fra en avis. Begge deler skjer lett om man ikke ber om noe annet.

Les alltid gjennom før du sender. En språkmodell kan finne på et tilskuertall eller en målscorer som ser helt rimelig ut. Vi kontrollerer alle bidrag, men det er langt lettere for oss om du har sjekket fakta mot kilden din først.

For eldre kamper arkivet ikke har ennå. Kampryggraden rekker tilbake til 1917, men detaljene — mål, oppstillinger, tilskuertall — begynner først rundt 2010.

Vanligst

Legg til en kamp som mangler

Du skal hjelpe meg å legge til en AaFK-kamp i det åpne arkivet https://github.com/mlervaag/aafkstats.

Kampen det gjelder: [BESKRIV KAMPEN — dato eller omtrentlig dato, motstander, og hva du vet]

Datamodellen, kort:

- Én YAML-fil per kamp: data/seasons/<år>/matches/<id>.yaml
- id = filnavn = <dato>-<hjemmelag>-<bortelag>, f.eks. 2011-11-06-sk-brann-aalesunds-fk
  Lagdelen er klubbens slug slik den heter i data/clubs/ (små bokstaver, bindestrek,
  æ→ae, ø→o, å→a).
- Påkrevd: id, date, status, competition.id, competition.season, home.clubId, away.clubId
- Alt annet er valgfritt. En kamp fra 1930 med bare dato og motstander er velkommen
  med confidence: probable — det er bedre enn at den mangler.
- competition.id er en av: andredivisjon, eliteserien, europa-liga, forstedivisjon, nm, treningskamp
- status: scheduled | played | abandoned | awarded | cancelled | postponed
- confidence: confirmed (to uavhengige kilder) | probable (én kilde) | disputed (kilder er uenige)

Viktig om resultat: home.score og away.score er stillingen etter ORDINÆR TID.
Mål i ekstraomganger føres i extraTime, og straffesparkkonkurranse i penaltyShootout.
En kamp som endte 1-1 og ble avgjort 4-3 på straffer skrives altså med score 1 og 1,
ikke 4 og 3.

Kildekrav — dette er ufravikelig:

- Hver opplysning skal kunne etterprøves. Legg inn sources[] med sourceId, url og
  retrievedAt (dagens dato), og list i fields[] hvilke felt kilden faktisk dekker.
- Finner du ikke en opplysning, LA FELTET STÅ TOMT. Ikke gjett, ikke rund av, ikke
  regn deg fram til et tilskuertall. Et hull er greit; en oppdiktet verdi er ikke.
- Er du usikker, sett confidence: probable og skriv hvorfor i PR-beskrivelsen.
- Motsier to kilder hverandre, behold begge i conflicts[] og sett confidence: disputed
  framfor å velge den ene i stillhet.

Slik vil jeg at du jobber:

1. Finn kampen i kilder du har tilgang til. Si tydelig fra hvilke du brukte.
2. Sjekk om motstanderklubben allerede finnes i data/clubs/. Gjør den ikke det,
   lag også en klubbfil med id, name, country og eventuelt founded og names[] hvis
   klubben har byttet navn.
3. Skriv den ferdige YAML-filen, klar til å lime inn.
4. List opp hva du IKKE fant, slik at jeg vet hva som mangler.

Slik leverer du:

1. Fork https://github.com/mlervaag/aafkstats
2. Lag en gren, f.eks. bidrag/1974-cupkamp
3. Legg til eller endre YAML-filene
4. Kjør «pnpm install» og deretter «pnpm validate» — den må si at arkivet validerer.
   Får du feil, rett dem før du sender. Feilmeldingene peker på felt og fil.
5. Åpne en pull request. Skriv i beskrivelsen hvilke kilder du brukte, og hva du
   eventuelt var usikker på.

Alle forslag kontrolleres før de slås sammen. Det er helt greit å sende noe du er
usikker på — bare si fra at du er det.

Når kampen finnes, men mangler målscorere, oppstilling, tilskuertall eller dommer.

Utdyping

Fyll ut detaljer på en kamp

Jeg vil fylle ut detaljer på en kamp som allerede ligger i det åpne AaFK-arkivet https://github.com/mlervaag/aafkstats.

Kampen: [LIM INN DAGENS YAML-FIL, eller oppgi kamp-ID]

Datamodellen, kort:

- Én YAML-fil per kamp: data/seasons/<år>/matches/<id>.yaml
- id = filnavn = <dato>-<hjemmelag>-<bortelag>, f.eks. 2011-11-06-sk-brann-aalesunds-fk
  Lagdelen er klubbens slug slik den heter i data/clubs/ (små bokstaver, bindestrek,
  æ→ae, ø→o, å→a).
- Påkrevd: id, date, status, competition.id, competition.season, home.clubId, away.clubId
- Alt annet er valgfritt. En kamp fra 1930 med bare dato og motstander er velkommen
  med confidence: probable — det er bedre enn at den mangler.
- competition.id er en av: andredivisjon, eliteserien, europa-liga, forstedivisjon, nm, treningskamp
- status: scheduled | played | abandoned | awarded | cancelled | postponed
- confidence: confirmed (to uavhengige kilder) | probable (én kilde) | disputed (kilder er uenige)

Viktig om resultat: home.score og away.score er stillingen etter ORDINÆR TID.
Mål i ekstraomganger føres i extraTime, og straffesparkkonkurranse i penaltyShootout.
En kamp som endte 1-1 og ble avgjort 4-3 på straffer skrives altså med score 1 og 1,
ikke 4 og 3.

Hendelser skrives slik, sortert på minutt:

events:
  - minute: 34
    type: goal
    team: home
    player: Fullt navn
    assist: Fullt navn        # utelates hvis ingen målgivende
  - minute: 67
    type: yellow_card
    team: away
    player: Fullt navn

Gyldige typer: goal, own_goal, penalty_goal, missed_penalty, yellow_card,
second_yellow_card, red_card, substitution (med playerOff), var_decision.
Tilleggstid skrives som minute: 45 med stoppage: 2 — ikke som minute: 47.

Kildekrav — dette er ufravikelig:

- Hver opplysning skal kunne etterprøves. Legg inn sources[] med sourceId, url og
  retrievedAt (dagens dato), og list i fields[] hvilke felt kilden faktisk dekker.
- Finner du ikke en opplysning, LA FELTET STÅ TOMT. Ikke gjett, ikke rund av, ikke
  regn deg fram til et tilskuertall. Et hull er greit; en oppdiktet verdi er ikke.
- Er du usikker, sett confidence: probable og skriv hvorfor i PR-beskrivelsen.
- Motsier to kilder hverandre, behold begge i conflicts[] og sett confidence: disputed
  framfor å velge den ene i stillhet.

Behold alt som allerede står i filen. Står et felt oppført i manual[], skal det
ikke endres — det er låst med vilje. Legg din kilde til i sources[] som en ny
oppføring; ikke overskriv kilden som var der.

Gi meg den komplette filen tilbake, og en liste over hva du la til.

Slik leverer du:

1. Fork https://github.com/mlervaag/aafkstats
2. Lag en gren, f.eks. bidrag/1974-cupkamp
3. Legg til eller endre YAML-filene
4. Kjør «pnpm install» og deretter «pnpm validate» — den må si at arkivet validerer.
   Får du feil, rett dem før du sender. Feilmeldingene peker på felt og fil.
5. Åpne en pull request. Skriv i beskrivelsen hvilke kilder du brukte, og hva du
   eventuelt var usikker på.

Alle forslag kontrolleres før de slås sammen. Det er helt greit å sende noe du er
usikker på — bare si fra at du er det.

Et kort, selvstendig sammendrag basert på flere kilder. Ingen kamper har referat ennå.

Tekst

Skriv et kampreferat

Jeg vil skrive et kampreferat til det åpne AaFK-arkivet https://github.com/mlervaag/aafkstats.

Kampen: [LIM INN YAML-FILEN ELLER BESKRIV KAMPEN]
Kilder jeg har: [LIM INN LENKER ELLER UTDRAG]

ABSOLUTT KRAV — les dette først:

Referatet skal være DIN EGEN formulering, skrevet for dette arkivet. Du skal ikke
kopiere setninger fra avisartikler, klubbsider eller andre referat, og du skal ikke
omskrive én enkelt artikkel setning for setning. Det siste er like ulovlig som å
kopiere, bare vanskeligere å oppdage. Bygg teksten på FAKTA fra flere kilder —
hvem scoret, når, hva som avgjorde — og skriv den fra bunnen.

Fakta er frie. Tekst er det ikke.

Har du bare én kilde, si fra om det i stedet for å skrive noe som ligger tett på den.

Formatet:

report:
  summary: En eller to setninger. Dette vises i lister og søk.
  body: |
    Tre til seks avsnitt. Hva som skjedde, hva som avgjorde, hva kampen betydde
    i sesongen. Nøktern tone — dette er et arkiv, ikke en heiarop.

Lenker til originalene legges ved som:

externalReports:
  - publisher: Sunnmørsposten
    title: Overskriften slik den står
    url: https://...
    date: 2011-11-06

Skriv referatet, og list opp hvilke faktapåstander som kommer fra hvilken kilde,
slik at jeg kan kontrollere dem.

Slik leverer du:

1. Fork https://github.com/mlervaag/aafkstats
2. Lag en gren, f.eks. bidrag/1974-cupkamp
3. Legg til eller endre YAML-filene
4. Kjør «pnpm install» og deretter «pnpm validate» — den må si at arkivet validerer.
   Får du feil, rett dem før du sender. Feilmeldingene peker på felt og fil.
5. Åpne en pull request. Skriv i beskrivelsen hvilke kilder du brukte, og hva du
   eventuelt var usikker på.

Alle forslag kontrolleres før de slås sammen. Det er helt greit å sende noe du er
usikker på — bare si fra at du er det.

Hva som mangler mest

Arkivet mangler fortsatt årene fra 1914 til 1916 – 3 sesonger, fordi protokollene som kreves for å hente dem ut mangler eller ligger innelåst. Opp- og nedrykkskvalifisering mangler helt, og ingen kamper har kampreferat ennå. Bidrag monner mest der.

Se sesongoversikten for hva som allerede ligger inne.