<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<style type="text/css" style="display:none;"> P {margin-top:0;margin-bottom:0;} </style>
</head>
<body dir="ltr">
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
Godt spørsmål Ole! Dokumentasjon finnes på mange måter.</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
nikita skal støtte swagger/openapi beskrivelser. Feks det ser du i controller:</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
<a href="https://gitlab.com/OsloMet-ABI/nikita-noark5-core/-/blob/master/src/main/java/nikita/webapp/web/controller/hateoas/FondsHateoasController.java#L45" id="LPNoLPOWALinkPreview">https://gitlab.com/OsloMet-ABI/nikita-noark5-core/-/blob/master/src/main/java/nikita/webapp/web/controller/hateoas/FondsHateoasController.java#L45</a><br>
</div>
<div class="_Entity _EType_OWALinkPreview _EId_OWALinkPreview _EReadonly_1"></div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
Det er mulig å starte nikita sammen med swagger-api beskrivelse. Men jeg har ikke løst samhandlings biten at du faktisk kan POSTE/PUT fra swagger.</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
Det er noe javadoc dokumentasjon. Feks</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
<a href="https://gitlab.com/OsloMet-ABI/nikita-noark5-core/-/blob/master/src/main/java/nikita/webapp/service/impl/FondsService.java#L83" id="LPNoLPOWALinkPreview_1">https://gitlab.com/OsloMet-ABI/nikita-noark5-core/-/blob/master/src/main/java/nikita/webapp/service/impl/FondsService.java#L83</a><br>
</div>
<div class="_Entity _EType_OWALinkPreview _EId_OWALinkPreview_1 _EReadonly_1"></div>
<br>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
men dette er også noe som burde blitt gjennomgått i mer detalj.</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
Nikita har integrert spring-restdocs-asciidoctor og når tester kjøres genereres det en <a href="https://asciidoctor.org/docs/" id="LPNoLPOWALinkPreview_2">https://asciidoctor.org/docs/</a> <span style="color: rgb(0, 0, 0); font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt;">fil</span></div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
<span style="color: rgb(0, 0, 0); font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt;"><br>
</span></div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
<span style="color: rgb(0, 0, 0); font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt;">Vi har desverre ikke hatt tid til å ta tak i dette og strømlinje det. </span></div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
<span style="color: rgb(0, 0, 0); font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt;"><br>
</span></div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
<span style="color: rgb(0, 0, 0); font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt;"> - Thomas</span></div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);" class="elementToProof">
<span style="color: rgb(0, 0, 0); font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt;"><br>
</span></div>
<div id="appendonsend"></div>
<hr style="display:inline-block;width:98%" tabindex="-1">
<div id="divRplyFwdMsg" dir="ltr"><font face="Calibri, sans-serif" style="font-size:11pt" color="#000000"><b>Fra:</b> nikita-noark <nikita-noark-bounces@nuug.no> på vegne av ole@aamot.software <ole@aamot.software><br>
<b>Sendt:</b> tirsdag 9. august 2022 11:05<br>
<b>Til:</b> Petter Reinholdtsen <pere@hungry.com><br>
<b>Kopi:</b> nikita-noark@nuug.no <nikita-noark@nuug.no><br>
<b>Emne:</b> Re: Er dokumentasjon relevant for arkiv?</font>
<div> </div>
</div>
<div>
<div dir="auto">
<div dir="auto">On Aug 9, 2022 9:48 AM, Petter Reinholdtsen <pere@hungry.com> wrote:<br>
</div>
<div class="x_gmail_extra" dir="auto">
<div class="x_gmail_quote">
<blockquote class="x_quote" style="margin:0 0 0 .8ex; border-left:1px #ccc solid; padding-left:1ex">
<p dir="ltr">[Thomas Sødring]<br>
> Ble tilsendt følgende lenke fra en kollega på arkivstudiet:<br>
><br>
> https://www.kode24.no/artikkel/rolfs-beste-tips-for-god-dokumentasjon-i-dag-er-dette-ekstremt-viktig/76736767</p>
<p dir="ltr">Takk for den. En nyttig påminning og et godt mentalt rammeverk for å<br>
vurdere dokumentasjonsbehovet.</p>
</blockquote>
</div>
</div>
<div dir="auto">Og javadoc benyttes naturligvis i Nikita?</div>
<div dir="auto"><br>
</div>
<div dir="auto">Jeg fant en bok med tittelen</div>
<div dir="auto"><br>
</div>
<div dir="auto">The Elements of Java Style</div>
<div dir="auto"><br>
</div>
<div dir="auto">hvor javadoc er beskrevet på side 42.</div>
<div dir="auto"><br>
</div>
<div dir="auto">Mvh,</div>
<div dir="auto">Ole</div>
<div dir="auto"><br>
</div>
<div class="x_gmail_extra" dir="auto">
<div class="x_gmail_quote">
<blockquote class="x_quote" style="margin:0 0 0 .8ex; border-left:1px #ccc solid; padding-left:1ex">
<p dir="ltr">_______________________________________________<br>
nikita-noark mailing list<br>
nikita-noark@nuug.no<br>
https://lists.nuug.no/mailman/listinfo/nikita-noark<br>
</p>
</blockquote>
</div>
<br>
</div>
</div>
</div>
</body>
</html>