← Tilbake til bloggen

Utviklernotater: Lagre teknisk innhold som kode-først Markdown

· Save Team
developercodedocumentationapitemplates

Du debugger klokken 02:00. Du finner Stack Overflow-svaret. Du trenger kodeblokken, forklaringen, og ikke noe annet. Ikke de 47 “meg også”-kommentarene. Ikke sidebarannonser. Ikke karusellen med relaterte spørsmål.

Saves Developer-mal fjerner alt bortsett fra det en utvikler faktisk trenger: kode, API-referanser og teknisk kontekst.

Utvikleres leseproblem

Teknisk innhold på nett er begravd under støy:

  • Stack Overflow — svar omgitt av stemmer, kommentarer, annonser
  • Dokumentasjon — viktig kode begravd i avsnitt med forklaring
  • Blog-tutorials — “Først, la meg fortelle deg hvorfor jeg elsker JavaScript…”
  • GitHub-READMEs — det ene kodeeksemplet du trenger er 400 linjer nede
  • API-referanser — nyttig tabell skjult blant vegger av prosa

Hvordan Developer-malen fungerer

Saves Developer-mal gir ut et kode-først-format med fem seksjoner:

  1. TL;DR — løsningen i én setning
  2. Oversikt — teknisk kontekst uten fluff
  3. Kodeeksempler — hver kodeblokk bevart nøyaktig
  4. API-referanse — tabeller med metoder, parametre, returtyper
  5. Notater — edge cases, gotchas, versjonsspesifikk oppførsel

Alle kodeblokker er bevart med syntaksutheving-markører. Teknisk sjargong forblir intakt. Markedsføringsspråk fjernes.

Eksempel på utdata

Fra en Next.js-dokumentasjonsside om Server Actions:

## TL;DR

Server Actions er async-funksjoner som kjører på serveren,
definert med 'use server'-direktivet, kallbart direkte fra
Client Components.

## Oversikt

Server Actions eliminerer behovet for API-ruter i de fleste
mutasjonsscenarier. De integreres med Next.js sine caching- og
revalidation-systemer. Tilgjengelig kun i App Router.

## Kodeeksempler

### Grunnleggende Server Action

\`\`\`typescript
'use server'

export async function createPost(formData: FormData) {
  const title = formData.get('title') as string
  await db.posts.create({ data: { title } })
  revalidatePath('/posts')
}
\`\`\`

### Bruk i en Client Component

\`\`\`typescript
'use client'

import { createPost } from './actions'

export function PostForm() {
  return (
    <form action={createPost}>
      <input name="title" />
      <button type="submit">Create</button>
    </form>
  )
}
\`\`\`

## API-referanse

| Funksjon | Parametre | Returnerer |
|----------|-----------|---------|
| revalidatePath | path: string | void |
| revalidateTag | tag: string | void |
| redirect | url: string | never |
| cookies() | none | ReadonlyRequestCookies |

## Notater

- Server Actions må være async-funksjoner
- 'use server'-direktivet kan være på funksjon- eller filnivå
- Maksimal request body-størrelse: 1MB som standard
- Fungerer med progressive enhancement (ingen JS kreves)
- Kan ikke defineres i Client Component-filer

Perfekte bruksområder

Lagre Stack Overflow-svar

Få det aksepterte svaret med kodeblokker, minus UI-rotet. Perfekt for å bygge et personlig kodereferansebibliotek.

Dokumentasjonssnapshot

Lagre dok-sider før de endres. Versjonerte API-er, utdaterte funksjoner, migreringsguider — behold en lokal kopi.

Tutorial-utvinning

Lagre kodingsveiledninger strippet ned til de essensielle trinnene og koden. Ingen forfatterbakgrunn, ingen SEO-fyll.

API-referansesamling

Bygg et personlig API-jukselapp ved å lagre referansesider i developer-format. Tabellutdataen er umiddelbart nyttig.

Kodegjennomgangskontekst

Lagre relevant dokumentasjon når du gjennomgår ukjent kode. Del developer-formaterte referanser i PR-kommentarer.

Hvordan sette opp

  1. Installer Save fra Chrome Web Store (gratis)
  2. Åpne Innstillinger og velg “Developer 💻”
  3. Besøk en hvilken som helst teknisk side — dok, Stack Overflow, tutorials
  4. Klikk Save — kode-først Markdown umiddelbart
  5. Lagre i hvelvet ditt — Obsidian, VS Code-notater, GitHub-wiki

Bygget for utviklere, av utviklere

Slutt å kopiere kodeblokker manuelt. Slutt å reformatere dokumentasjon. Slutt å vade gjennom tutorial-fluff for å finne den ene kommandoen du trenger.

Saves Developer-mal gir deg kode-først Markdown fra enhver teknisk side. Rent, strukturert, klart til bruk.

Prøv Save gratis på Chrome Web Store