Style guide
Under følger en styleguide til Kartverkets dokumentasjon.
Klarspråk
- Bruk klart og tydelig språk. Husk at Kartverket er avsender.
- Vi skriver dokumentasjonen på norsk. Det inkluderer også filnavn, id'er og url'er.
Der engelske ord er brukt på norsk kan disse brukes (fesk SLA, faq eller support) eller der de har spesiell betydning (
index.mdxsom landingsside)
Spesielle stavemåter
- Geonorge staves med liten n
Linker
Bruk <DocuLink> for interne linker og <Link> for eksterne for å fange opp når lenker endrer seg.
Figurer
Bruk Mermaid for figurer, se Docusaurus sin egen dokumentasjon https://docusaurus.io/docs/markdown-features/diagrams