Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

List Nikita som referanseimplementasjon #262

Open
petterreinholdtsen opened this issue Apr 2, 2020 · 5 comments
Open

List Nikita som referanseimplementasjon #262

petterreinholdtsen opened this issue Apr 2, 2020 · 5 comments
Assignees
Labels
Noark 5.1 Noark 5.1

Comments

@petterreinholdtsen
Copy link
Collaborator


       Prosjekt  NOARK 5 Tjenestegresesnitt
       Kategori  Noark 5.5.0 TG versjon 1.0
    Alvorlighet  kommentar
   Meldingstype  utelatt
Brukerreferanse  [email protected]
    Dokumentdel  2
     Sidenummer  3
    Linjenummer  70

Beskrivelse

Tjenestegrensesnittet trenger minst en referanseimplementasjon for å demonstrere hvordan det fungerer. Jeg foreslår å liste opp Nikita som referanseimplementasjon. Kapittel 2 virker å være en god plass å liste opp referanseimplementasjoner.

Ønsket endring

Legg inn et avsnitt/setning i kapittel to om referanseimplementasjoner og pek til Nikitas nettsted https://gitlab.com/OsloMet-ABI/nikita-noark5-core .

@monadani
Copy link
Collaborator

Sjekkes ut med Espen Sjøvoll,

@monadani monadani self-assigned this Apr 17, 2020
@monadani monadani added the Noark 5.1 Noark 5.1 label Apr 17, 2020
@petterreinholdtsen
Copy link
Collaborator Author

petterreinholdtsen commented Apr 17, 2020 via email

@monadani
Copy link
Collaborator

@petterreinholdtsen , kan du svare ut dette:
Hva menes med objektiv referanseinstallasjon, og hva det innebærer i praksis, hva det skal brukes til etc?

Burde det ikke være en referanseinstallasjon av alle løsninger som er compliant slik at man kan teste etterlevelse?

@petterreinholdtsen
Copy link
Collaborator Author

Litt usikker på hvor begrepet "referanseinstallasjon" kommer fra, men skal forsøke å forklare bedre hva jeg mener. Jeg forsøkte å finne en god definisjon fra IETF på refereranseimplementasjon uten å lykkes, men fant https://en.wikipedia.org/wiki/Reference_implementation som forklarer i grove trekk hva en referanseimplementasjon er for noe.

Konkret vil en erklæring om at Nikita er referanseimplementasjon for Noark 5 Tjenestegrensesnitt gjøre at alle som forsøker å forstå hvordan spesifikasjonen skal tolkes vil se på hvordan ting er løst i Nikita, og Nikitas løsning vil være anbefalt tilnærming hvis spesifikasjonen er uklar. I og med at Nikita er tilgjengelig uten bruksbegresninger, kan alle som ønsker å teste ut tjenestegrensesnittet enten sette opp sin egen instans eller koble seg til testinstansen Nikitaprosjektet har kjørende på https://nikita.oslomet.no/noark5v5/api/ .

Det å ha en referanseimplementasjon dokumenterer i tillegg at spesifikasjonen lar seg implementere, og gjør det klart at alle som vil kan komme enkelt i gang med Noark 5 Tjenestegrensesnitt ved å bruke en fri programvareløsning.

@petterreinholdtsen
Copy link
Collaborator Author

Jeg spurte IETF om de hadde noen gode referanser for definisjonen av referanseimplementasjon, og de fant ikke noe som helt traff det jeg spurte om, men henviste til https://www.rfc-editor.org/rfc/rfc5657.html og https://www.rfc-editor.org/rfc/rfc7942.html som begge forklarer litt om hvordan IETF ønsker ulike implementasjoner av standardene der skal rapportere sin eksistens og omtales i RFC-tekstene. Begge deler er relevant bakgrunnsmateriale her.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Noark 5.1 Noark 5.1
Projects
None yet
Development

No branches or pull requests

2 participants