Førsteutkast "Den gode implementasjonsguide" (DGI)

[rockphotog]

Undertegnede er redaktør for førsteutkast til veiledning/retningslinje for implementasjonsguider. Veiledningen skal være ferdigstilt i en 1.0-versjon innen utgangen av 2020.

Vi ønsker et godt samarbeid med alle rundt utarbeidelsen. Vi vil dokumentere i wiki'en, men deler eller hele veiledningen har som mål å bli normert av Direktoratet for e-helse.

Vi bruker forkortelsen "DGI" i anledning utarbeidelsen, som tag, overskrift i issues etc.

[rockphotog]

Typiske ting som må eller kan være med i en ID (min råliste):

• Beskrivelse av anvendelse og formål, herunder use case
• Definisjoner, tolkninger og krav
• Sammenheng med andre IG, profiler, prosjekter etc.
• Dokumentasjon av profilene, utvidelser, kodeverk, evt. operasjoner og søkeparameter
• Evt. conformance-krav
• Eksempler

[rockphotog]

Tilbakemeldinger og bidrag skjer på følgende tre måter:

• Issues (tag med DGI), inkludert denne for generell diskusjon
• Feature-branch på selve dokumentasjonen (tag med DGI)

Ingen issue er for liten, selv om det dreier seg om skrivefeil.

Det blir også diskutert utover høsten i arbeidsmøter, workshops etc.

[rockphotog]

Utvikling skjer i branch: https://github.com/HL7Norway/best-practice/tree/develop-den-gode-implementasjonsguide

Kladd hovedside dokument:
https://github.com/HL7Norway/best-practice/blob/develop-den-gode-implementasjonsguide/docs/dgi/index.md

[rockphotog]

Se også #78