Skip to content

Onboarding for kravskrivere uten git-erfaring - #605

Open
joranindseth wants to merge 1 commit into
mainfrom
dok/onboarding-for-kravskrivere
Open

joranindseth wants to merge 1 commit into
mainfrom
dok/onboarding-for-kravskrivere

Conversation

@joranindseth

Copy link
Copy Markdown
Collaborator

Hva

Ny ONBOARDING.md i repo-rota, skrevet for domeneeksperter som skal skrive krav her, men som ikke har jobbet i et kodelager før.

Bakgrunnen er konkret: begreper som push, pull, PR og MR er en reell inngangsbarriere for kravskrivere, og README.md forklarer hva repoet inneholder, ikke hvordan man jobber i det.

Innhold

  • Fire-steder-modellen — arbeidsmappe, commit, branch, main. Den forklaringen løser mest forvirring alene.
  • Ordliste på norsk, inkludert at PR (GitHub) og MR (GitLab) er samme sak. Sikt bruker begge plattformer.
  • Arbeidsflyt i fem steg, med regelen om én branch per sak.
  • Hva kravskriveren eier selv (innholdet, når noe er klart for PR) og hva som kan delegeres til Claude Code.
  • Koblingen krav ↔ GitHub-issue — når issuet må oppdateres og når det ikke må.
  • Tag-løpet @draft@planned@in-progress@implemented.
  • Arbeidsdelingen mellom .feature (hva) og .design.md (hvordan).
  • Feilsituasjonstabell — hva man ber om når man har rotet.

Ett punkt som bør vurderes av noen andre

Dokumentet påpeker at .github/FS-github-oppsett.md beskriver type:feature og priority:high som obligatoriske labels, mens ingen av dem finnes i repoets labelliste. I praksis brukes prosessområde-labels (Opptak, Kompetanse, initiativ osv.).

Det er skrevet som et forbehold i onboardingen, men den egentlige løsningen er nok å rette opp i FS-github-oppsett.md — enten ved å opprette labelene eller ved å fjerne omtalen. Det er utenfor scope her.

Dokumentet beskriver også at main ikke er beskyttet mot direkte push, med en klar anbefaling om å bruke PR uansett. Si fra hvis det heller bør løses teknisk enn med en formaning.

🤖 Generated with Claude Code

Veiledning for domeneeksperter som skal skrive krav i repoet, men som ikke har
jobbet i et kodelager før. Forklarer forskjellen på arbeidsmappe, commit,
branch og main, at PR og MR er samme sak, og hvilken arbeidsflyt som faktisk
brukes her.

Tar også med koblingen mellom .feature-filer og GitHub-issues, tag-løpet fra
@draft til @implemented, arbeidsdelingen mellom .feature og .design.md, og
hvilke Claude Code-skills som finnes.

Merk: dokumentet påpeker at .github/FS-github-oppsett.md beskriver type:- og
priority:-labels som ikke finnes i repoet, og at prosessområde-labels brukes i
praksis.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant