Generated.

[homepage.git] / blog / archive / 2019 / 03 / 03.rss

<?xml version="1.0" encoding="ISO-8859-1"?>
<rss version='2.0' xmlns:lj='http://www.livejournal.org/rss/lj/1.0/'>
        <channel>
                <title>Petter Reinholdtsen - Entries from March 2019</title>
                <description>Entries from March 2019</description>
                <link>http://www.hungry.com/~pere/blog/</link>

        
        <item>
                <title>PlantUML for text based UML diagram modelling - nice free software</title>
                <link>http://www.hungry.com/~pere/blog/PlantUML_for_text_based_UML_diagram_modelling___nice_free_software.html</link>        
                <guid isPermaLink="true">http://www.hungry.com/~pere/blog/PlantUML_for_text_based_UML_diagram_modelling___nice_free_software.html</guid>
                <pubDate>Mon, 25 Mar 2019 09:35:00 +0100</pubDate>
                <description>&lt;p&gt;As part of my involvement with the
&lt;a href=&quot;https://gitlab.com/OsloMet-ABI/nikita-noark5-core/&quot;&gt;Nikita
Noark 5 core project&lt;/a&gt;, I have been proposing improvements to the
API specification created by &lt;a href=&quot;https://www.arkivverket.no/&quot;&gt;The
National Archives of Norway&lt;/a&gt; and helped migrating the text from a
version control system unfriendly binary format (docx) to Markdown in
git.  Combined with the migration to a public git repository (on
github), this has made it possible for anyone to suggest improvement
to the text.&lt;/p&gt;

&lt;p&gt;The specification is filled with UML diagrams.  I believe the
original diagrams were modelled using Sparx Systems Enterprise
Architect, and exported as EMF files for import into docx.  This
approach make it very hard to track changes using a version control
system.  To improve the situation I have been looking for a good text
based UML format with associated command line free software tools on
Linux and Windows, to allow anyone to send in corrections to the UML
diagrams in the specification.  The tool must be text based to work
with git, and command line to be able to run it automatically to
generate the diagram images.  Finally, it must be free software to
allow anyone, even those that can not accept a non-free software
license, to contribute.&lt;/p&gt;

&lt;p&gt;I did not know much about free software UML modelling tools when I
started.  I have used dia and inkscape for simple modelling in the
past, but neither are available on Windows, as far as I could tell.  I
came across a nice
&lt;a href=&quot;https://modeling-languages.com/text-uml-tools-complete-list/&quot;&gt;list
of text mode uml tools&lt;/a&gt;, and tested out a few of the tools listed
there.  &lt;a href=&quot;http://plantuml.com/&quot;&gt;The PlantUML tool&lt;/a&gt; seemed
most promising.  After verifying that the packages
&lt;a href=&quot;https://tracker.debian.org/pkg/plantuml&quot;&gt;is available in
Debian&lt;/a&gt; and found &lt;a href=&quot;https://github.com/plantuml/plantuml&quot;&gt;its
Java source&lt;/a&gt; under a GPL license on github, I set out to test if it
could represent the diagrams we needed, ie the ones currently in
&lt;a href=&quot;https://github.com/arkivverket/noark5-tjenestegrensesnitt-standard/&quot;&gt;the
Noark 5 Tjenestegrensesnitt specification&lt;/a&gt;.  I am happy to report
that it could represent them, even thought it have a few warts here
and there.&lt;/p&gt;

&lt;p&gt;After a few days of modelling I completed the task this weekend.  A
temporary link to the complete set of diagrams (original and from
PlantUML) is available in
&lt;a href=&quot;https://github.com/arkivverket/noark5-tjenestegrensesnitt-standard/issues/76&quot;&gt;the
github issue discussing the need for a text based UML format&lt;/a&gt;, but
please note I lack a sensible tool to convert EMF files to PNGs, so
the &quot;original&quot; rendering is not as good as the original was in the
publised PDF.&lt;/p&gt;

&lt;p&gt;Here is an example UML diagram, showing the core classes for
keeping metadata about archived documents:&lt;/p&gt;

&lt;pre&gt;
@startuml
skinparam classAttributeIconSize 0

!include media/uml-class-arkivskaper.iuml
!include media/uml-class-arkiv.iuml
!include media/uml-class-klassifikasjonssystem.iuml
!include media/uml-class-klasse.iuml
!include media/uml-class-arkivdel.iuml
!include media/uml-class-mappe.iuml
!include media/uml-class-merknad.iuml
!include media/uml-class-registrering.iuml
!include media/uml-class-basisregistrering.iuml
!include media/uml-class-dokumentbeskrivelse.iuml
!include media/uml-class-dokumentobjekt.iuml
!include media/uml-class-konvertering.iuml
!include media/uml-datatype-elektronisksignatur.iuml

Arkivstruktur.Arkivskaper &quot;+arkivskaper 1..*&quot; &lt;-o &quot;+arkiv 0..*&quot; Arkivstruktur.Arkiv
Arkivstruktur.Arkiv o--&gt; &quot;+underarkiv 0..*&quot; Arkivstruktur.Arkiv
Arkivstruktur.Arkiv &quot;+arkiv 1&quot; o--&gt; &quot;+arkivdel 0..*&quot; Arkivstruktur.Arkivdel
Arkivstruktur.Klassifikasjonssystem &quot;+klassifikasjonssystem [0..1]&quot; &lt;--o &quot;+arkivdel 1..*&quot; Arkivstruktur.Arkivdel
Arkivstruktur.Klassifikasjonssystem &quot;+klassifikasjonssystem [0..1]&quot; o--&gt; &quot;+klasse 0..*&quot; Arkivstruktur.Klasse
Arkivstruktur.Arkivdel &quot;+arkivdel 0..1&quot; o--&gt; &quot;+mappe 0..*&quot; Arkivstruktur.Mappe
Arkivstruktur.Arkivdel &quot;+arkivdel 0..1&quot; o--&gt; &quot;+registrering 0..*&quot; Arkivstruktur.Registrering
Arkivstruktur.Klasse &quot;+klasse 0..1&quot; o--&gt; &quot;+mappe 0..*&quot; Arkivstruktur.Mappe
Arkivstruktur.Klasse &quot;+klasse 0..1&quot; o--&gt; &quot;+registrering 0..*&quot; Arkivstruktur.Registrering
Arkivstruktur.Mappe --&gt; &quot;+undermappe 0..*&quot; Arkivstruktur.Mappe
Arkivstruktur.Mappe &quot;+mappe 0..1&quot; o--&gt; &quot;+registrering 0..*&quot; Arkivstruktur.Registrering
Arkivstruktur.Merknad &quot;+merknad 0..*&quot; &lt;--* Arkivstruktur.Mappe
Arkivstruktur.Merknad &quot;+merknad 0..*&quot; &lt;--* Arkivstruktur.Dokumentbeskrivelse
Arkivstruktur.Basisregistrering -|&gt; Arkivstruktur.Registrering
Arkivstruktur.Merknad &quot;+merknad 0..*&quot; &lt;--* Arkivstruktur.Basisregistrering
Arkivstruktur.Registrering &quot;+registrering 1..*&quot; o--&gt; &quot;+dokumentbeskrivelse 0..*&quot; Arkivstruktur.Dokumentbeskrivelse
Arkivstruktur.Dokumentbeskrivelse &quot;+dokumentbeskrivelse 1&quot; o-&gt; &quot;+dokumentobjekt 0..*&quot; Arkivstruktur.Dokumentobjekt
Arkivstruktur.Dokumentobjekt *-&gt; &quot;+konvertering 0..*&quot; Arkivstruktur.Konvertering
Arkivstruktur.ElektroniskSignatur -[hidden]-&gt; Arkivstruktur.Dokumentobjekt
@enduml
&lt;/pre&gt;

&lt;p&gt;&lt;a href=&quot;http://plantuml.com/class-diagram&quot;&gt;The format&lt;/a&gt; is quite
compact, with little redundant information.  The text expresses
entities and relations, and there is little layout related fluff.  One
can reuse content by using include files, allowing for consistent
naming across several diagrams.  The include files can be standalone
PlantUML too.  Here is the content of
&lt;tt&gt;media/uml-class-arkivskaper.iuml&lt;/tt&gt;:&lt;/p&gt;

&lt;pre&gt;
@startuml
class Arkivstruktur.Arkivskaper &lt;Arkivenhet&gt; {
  +arkivskaperID : string
  +arkivskaperNavn : string
  +beskrivelse : string [0..1]
}
@enduml
&lt;/pre&gt;

&lt;p&gt;This is what the complete diagram for the PlantUML notation above
look like:&lt;/p&gt;

&lt;p&gt;&lt;img width=&quot;80%&quot; src=&quot;http://www.hungry.com/~pere/blog/images/2019-03-25-noark5-plantuml-diagrameksempel.png&quot;&gt;&lt;/p&gt;

&lt;p&gt;A cool feature of PlantUML is that the generated PNG files include
the entire original source diagram as text.  The source (with include
statements expanded) can be extracted using for example
&lt;tt&gt;exiftool&lt;/tt&gt;.  Another cool feature is that parts of the entities
can be hidden after inclusion.  This allow to use include files with
all attributes listed, even for UML diagrams that should not list any
attributes.&lt;/p&gt;

&lt;p&gt;The diagram also show some of the warts.  Some times the layout
engine place text labels on top of each other, and some times it place
the class boxes too close to each other, not leaving room for the
labels on the relationship arrows.  The former can be worked around by
placing extra newlines in the labes (ie &quot;\n&quot;).  I did not do it here
to be able to demonstrate the issue.  I have not found a good way
around the latter, so I normally try to reduce the problem by changing
from vertical to horizontal links to improve the layout.&lt;/p&gt;

&lt;p&gt;All in all, I am quite happy with PlantUML, and very impressed with
how quickly its lead developer responds to questions.  So far I got an
answer to my questions in a few hours when I send an email.  I
definitely recommend looking at PlantUML if you need to make UML
diagrams.  Note, PlantUML can draw a lot more than class relations.
Check out the documention for a complete list. :)&lt;/p&gt;

&lt;p&gt;As usual, if you use Bitcoin and want to show your support of my
activities, please send Bitcoin donations to my address
&lt;b&gt;&lt;a href=&quot;bitcoin:15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b&quot;&gt;15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b&lt;/a&gt;&lt;/b&gt;.&lt;/p&gt;
</description>
        </item>
        
        <item>
                <title>Release 0.3 of free software archive API system Nikita announced</title>
                <link>http://www.hungry.com/~pere/blog/Release_0_3_of_free_software_archive_API_system_Nikita_announced.html</link>        
                <guid isPermaLink="true">http://www.hungry.com/~pere/blog/Release_0_3_of_free_software_archive_API_system_Nikita_announced.html</guid>
                <pubDate>Sun, 24 Mar 2019 14:30:00 +0100</pubDate>
                <description>&lt;p&gt;Yesterday,  a new release of 
&lt;a href=&quot;https://gitlab.com/OsloMet-ABI/nikita-noark5-core/&quot;&gt;Nikita
Noark 5 core project&lt;/a&gt; was
&lt;a href=&quot;https://lists.nuug.no/pipermail/nikita-noark/2019-March/000451.html&quot;&gt;announced
on the project mailing list&lt;/a&gt;.  The free software solution is an
implementation of the Norwegian archive standard Noark 5 used by
government offices in Norway.  These were the changes in version 0.3
since version 0.2.1 (from NEWS.md):&lt;/p&gt;

&lt;ul&gt;
  &lt;li&gt;Improved ClassificationSystem and Class behaviour.&lt;/li&gt;
  &lt;li&gt;Tidied up known inconsistencies between domain model and hateaos links.&lt;/li&gt;
  &lt;li&gt;Added experimental code for blockchain integration.  &lt;/li&gt;
  &lt;li&gt;Make token expiry time configurable at upstart from properties file.&lt;/li&gt;
  &lt;li&gt;Continued work on OData search syntax.&lt;/li&gt;
  &lt;li&gt;Started work on pagination for entities, partly implemented for Saksmappe.&lt;/li&gt;
  &lt;li&gt;Finalise ClassifiedCode Metadata entity.&lt;/li&gt;
  &lt;li&gt;Implement mechanism to check if authentication token is still
   valid.  This allow the GUI to return a more sensible message to the
   user if the token is expired.&lt;/li&gt;
  &lt;li&gt;Reintroduce browse.html page to allow user to browse JSON API using
   hateoas links.&lt;/li&gt;
  &lt;li&gt;Fix bug in handling file/mappe sequence number.  Year change was
   not properly handled.&lt;/li&gt;
  &lt;li&gt;Update application yml files to be in sync with current development.&lt;/li&gt;
  &lt;li&gt;Stop &#39;converting&#39; everything to PDF using libreoffice.  Only
   convert the file formats doc, ppt, xls, docx, pptx, xlsx, odt, odp
   and ods.&lt;/li&gt;
  &lt;li&gt;Continued code style fixing, making code more readable.&lt;/li&gt;
  &lt;li&gt;Minor bug fixes.&lt;/li&gt;
  
&lt;/ul&gt;

&lt;p&gt;If free and open standardized archiving API sound interesting to
you, please contact us on IRC
(&lt;a href=&quot;irc://irc.freenode.net/%23nikita&quot;&gt;#nikita on
irc.freenode.net&lt;/a&gt;) or email
(&lt;a href=&quot;https://lists.nuug.no/mailman/listinfo/nikita-noark&quot;&gt;nikita-noark
mailing list&lt;/a&gt;).&lt;/p&gt;

&lt;p&gt;As usual, if you use Bitcoin and want to show your support of my
activities, please send Bitcoin donations to my address
&lt;b&gt;&lt;a href=&quot;bitcoin:15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b&quot;&gt;15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b&lt;/a&gt;&lt;/b&gt;.&lt;/p&gt;
</description>
        </item>
        
        <item>
                <title>Åpen og gjennomsiktig vedlikehold av spesifikasjonen for Noark 5 Tjenestegrensesnitt</title>
                <link>http://www.hungry.com/~pere/blog/_pen_og_gjennomsiktig_vedlikehold_av_spesifikasjonen_for_Noark_5_Tjenestegrensesnitt.html</link>        
                <guid isPermaLink="true">http://www.hungry.com/~pere/blog/_pen_og_gjennomsiktig_vedlikehold_av_spesifikasjonen_for_Noark_5_Tjenestegrensesnitt.html</guid>
                <pubDate>Mon, 11 Mar 2019 16:00:00 +0100</pubDate>
                <description>&lt;p&gt;Et virksomhetsarkiv for meg, er et arbeidsverktøy der en enkelt kan
finne informasjonen en trenger når en trenger det, og der
virksomhetens samlede kunnskap er tilgjengelig. Det må være greit å
finne frem i, litt som en bibliotek. Men der et bibliotek gjerne tar
vare på offentliggjort informasjon som er tilgjengelig flere steder,
tar et arkiv vare på virksomhetsintern og til tider personlig
informasjon som ofte kun er tilgjengelig fra et sted.&lt;/p&gt;

&lt;p&gt;Jeg mistenker den eneste måten å sikre at arkivet inneholder den
samlede kunnskapen i en virksomhet, er å bruke det som virksomhetens
kunnskapslager. Det innebærer å automatisk kopiere (brev, epost,
SMS-er etc) inn i arkivet når de sendes og mottas, og der filtrere
vekk det en ikke vil ta vare på, og legge på metadata om det som er
samlet inn for enkel gjenfinning. En slik bruk av arkivet innebærer at
arkivet er en del av daglig virke, ikke at det er siste hvilested for
informasjon ingen lenger har daglig bruk for. For å kunne være en del
av det daglige virket må arkivet enkelt kunne integreres med andre
systemer.  I disse dager betyr det å tilby arkivet som en
nett-tjeneste til hele virksomheten, tilgjengelig for både mennesker
og datamaskiner.  Det betyr i tur å både tilby nettsider og et
maskinlesbart grensesnitt.&lt;/p&gt;

&lt;p&gt;For noen år siden erkjente visjonære arkivarer fordelene med et
standardisert maskinlesbart grensesnitt til organisasjonens arkiv.  De
gikk igang med å lage noe de kalte
&lt;a href=&quot;https://github.com/arkivverket/noark5-tjenestegrensesnitt-standard/&quot;&gt;Noark
5 Tjenestegrensesnitt&lt;/a&gt;.  Gjort riktig, så åpner slike maskinlesbare
grensesnitt for samvirke på tvers av uavhengige programvaresystemer.
Gjort feil, vil det blokkere for samvirke og bidra til
leverandørinnlåsing.  For å gjøre det riktig så må grensesnittet være
klart og entydig beskrevet i en spesifikasjon som gjør at
spesifikasjonen tolkes på samme måte uavhengig av hvem som leser den,
og uavhengig av hvem som tar den i bruk.&lt;/p&gt;

&lt;p&gt;For å oppnå klare og entydige beskrivelser i en spesifikasjon, som
trengs for å kunne få en fri og åpen standard (se
&lt;a href=&quot;http://www.hungry.com/~pere/blog/Fri_og__pen_standard__slik_Digistan_ser_det.html&quot;&gt;Digistan-definisjon&lt;/a&gt;),
så trengs det en åpen og gjennomsiktig inngangsport med lav terskel,
der de som forsøker å ta den i bruk enkelt kan få inn korreksjoner,
etterlyse klargjøringer og rapportere uklarheter i spesifikasjonen.
En trenger også automatiserte datasystemer som måler og sjekker at et
gitt grensesnitt fungerer i tråd med spesifikasjonen.&lt;/p&gt;

&lt;p&gt;For Noark 5 Tjenestegrensesnittet er det nå etablert en slik åpen
og gjennomsiktig inngangsport på prosjekttjenesten github.  Denne
inngangsporten består først og fremst av en åpen portal som lar enhver
se hva som er gjort av endringer i spesifikasjonsteksten over tid, men
det hører også med et åpent &amp;quot;diskusjonsforum&amp;quot; der en kan
komme med endringsforslag og forespørsler om klargjøringer.  Alle
registrerte brukere på github kan bidra med innspill til disse
henvendelsene.&lt;/p&gt;

&lt;p&gt;I samarbeide med Arkivverket har jeg fått opprettet et git-depot
med spesifikasjonsteksten for tjenestegrensesnittet, der det er lagt
inn historikk for endringer i teksten de siste årene, samt lagt inn
endringsforslag og forespørsler om klargjøring av teksten.  Bakgrunnen
for at jeg bidro med dette er at jeg er involvert i
&lt;a href=&quot;https://gitlab.com/OsloMet-ABI/nikita-noark5-core&quot;&gt;Nikita-prosjektet&lt;/a&gt;,
som lager en fri programvare-utgave av Noark 5 Tjenestegrensesnitt.
Det er først når en forsøker å lage noe i tråd med en spesifikasjon at
en oppdager hvor mange detaljer som må beskrives i spesifikasjonen for
å sikre samhandling.&lt;/p&gt;

&lt;p&gt;Spesifikasjonen vedlikeholdes i et rent tekstformat, for å ha et
format egnet for versjonskontroll via versjontrollsystemet git.  Dette
gjør det både enkelt å se konkret hvilke endringer som er gjort når,
samt gjør det praktisk mulig for enhver med github-konto å sende inn
endringsforslag med formuleringer til spesifikasjonsteksten.  Dette
tekstformatet vises frem som nettsider på github, slik at en ikke
trenger spesielle verktøy for å se på siste utgave av
spesifikasjonen.&lt;/p&gt;

&lt;p&gt;Fra dette rene tekstformatet kan det så avledes ulike formater, som
HTML for websider, PDF for utskrift på papir og ePub for lesing med
ebokleser.  Avlednings-systemet (byggesystemet) bruker i dag
verktøyene pandoc, latex, docbook-xsl og GNU make til
transformasjonen.  Tekstformatet som brukes dag er
&lt;a href=&quot;https://www.markdownguide.org/&quot;&gt;Markdown&lt;/a&gt;, men det vurderes
å
&lt;a href=&quot;https://github.com/arkivverket/noark5-tjenestegrensesnitt-standard/issues/9&quot;&gt;endre
til formatet RST&lt;/a&gt; i fremtiden for bedre styring av utseende på
PDF-utgaven.&lt;/p&gt;

&lt;p&gt;Versjonskontrollsystemet git ble valgt da det er både fleksibelt,
avansert og enkelt å ta i bruk. Github ble valgt (foran f.eks. Gitlab
som vi bruker i Nikita), da Arkivverket allerede hadde tatt i bruk
Github i andre sammenhenger.&lt;/p&gt;

&lt;p&gt;Enkle endringer i teksten kan gjøres av priviligerte brukere
direkte i nettsidene til Github, ved å finne aktuell fil som skal
endres (f.eks. kapitler/03-konformitet.md), klikke på den lille
bokstaven i høyre hjørne over teksten. Det kommer opp en nettside der
en kan endre teksten slik en ønsker. Når en er fornøyd med endringen
så må endringen &amp;quot;sjekkes inn&amp;quot; i historikken. Det gjøres ved
å gi en kort beskrivelse av endringen (beskriv helst hvorfor endringen
trengs, ikke hva som er endret), under overskriften &amp;quot;Commit
changes&amp;quot;. En kan og bør legge inn en lengre forklaring i det
større skrivefeltet, før en velger om endringen skal sendes direkte
til &#39;master&#39;-grenen (dvs. autorativ utgave av spesifikasjonen) eller
om en skal lage en ny gren for denne endringen og opprette en
endringsforespørsel (aka &amp;quot;Pull Request&amp;quot;/PR). Når alt dette
er gjort kan en velge &amp;quot;Commit changes&amp;quot; for å sende inn
endringen. Hvis den er lagt inn i &amp;quot;master&amp;quot;-grenen så er den
en offisiell del av spesifikasjonen med en gang.  Hvis den derimot er
en endringsforespørsel, så legges den inn i
&lt;a href=&quot;https://github.com/arkivverket/noark5-tjenestegrensesnitt-standard/pulls&quot;&gt;listen
over forslag til endringer&lt;/a&gt; som venter på korrekturlesing og
godkjenning.&lt;/p&gt;

&lt;p&gt;Større endringer (for eksempel samtidig endringer i flere filer)
gjøres enklest ved å hente ned en kopi av git-depoet lokalt og gjøre
endringene der før endringsforslaget sendes inn. Denne prosessen er
godt beskrivet i dokumentasjon fra github.  Git-prosjektet som skal
&amp;quot;klones&amp;quot; er
&lt;a href=&quot;https://github.com/arkivverket/noark5-tjenestegrensesnitt-standard/&quot;&gt;https://github.com/arkivverket/noark5-tjenestegrensesnitt-standard/&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;For å registrere nye utfordringer (issues) eller kommentere på
eksisterende utfordringer benyttes nettsiden
&lt;a href=&quot;https://github.com/arkivverket/noark5-tjenestegrensesnitt-standard/issues&quot;&gt;https://github.com/arkivverket/noark5-tjenestegrensesnitt-standard/issues&lt;/a&gt;.
I skrivende stund er det 48 åpne og 11 avsluttede utfordringer.  Et
forslag til hva som bør være med når en beskriver en utfordring er
tilgjengelig som utfordring
&lt;a href=&quot;https://github.com/arkivverket/noark5-tjenestegrensesnitt-standard/issues/14&quot;&gt;#14&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;For å bygge en PDF-utgave av spesifikasjonen så bruker jeg i dag en
Debian GNU/Linux-maskin med en rekke programpakker installert.  Når
dette er på plass, så holder det å kjøre kommandoen &#39;make pdf html&#39; på
kommandolinjen, vente ca. 20 sekunder, før spesifikasjon.pdf og
spesifikasjon.html ligger klar på disken. Verktøyene for bygging av
PDF, HTML og ePub-utgave er også tilgjengelig på Windows og
MacOSX.&lt;/p&gt;

&lt;p&gt;Github bidrar med rammeverket.  Men for at åpent vedlikehold av
spesifikasjonen skal fungere, så trengs det folk som bidrar med sin
tid og kunnskap.  Arkivverket har sagt de skal bidra med innspill og
godkjenne forslag til endringer, men det blir størst suksess hvis alle
som bruker og lager systemer basert på Noark 5 Tjenestegrensesnitt
bidrar med sin kunnskap og kommer med forslag til forebedringer.  Jeg
stiller.  Blir du med?&lt;/p&gt;

&lt;p&gt;Det er viktig å legge til rette for åpen diskusjon blant alle
interesserte, som ikke krever at en må godta lange kontrakter med
vilkår for deltagelse. Inntil Arkivverket dukker opp på IRC har vi
laget en IRC-kanal der interesserte enkelt kan orientere seg og
diskutere tjenestegrensesnittet. Alle er velkommen til å ta turen
innom
&lt;a href=&quot;https://webchat.freenode.net/?channels=nikita&quot;&gt;#nikita&lt;/a&gt;
(f.eks. via irc.freenode.net) for å møte likesinnede.&lt;/p&gt;

&lt;p&gt;Det holder dog ikke å ha en god spesifikasjon, hvis ikke de som tar
den i bruk gjør en like god jobb. For å automatisk teste om et konkret
tjenestegrensesnitt følger (min) forståelse av
spesifikasjonsdokumentet, har jeg skrevet et program som kobler seg
opp til et Noark 5v4 REST-tjeneste og tester alt den finner for å se
om det er i henhold til min tolkning av spesifikasjonen.  Dette
verktøyet er tilgjengelig fra
&lt;a href=&quot;https://github.com/petterreinholdtsen/noark5-tester&quot;&gt;https://github.com/petterreinholdtsen/noark5-tester&lt;/a&gt;,
og brukes daglig mens vi utvikler Nikita for å sikre at vi ikke
introduserer nye feil.  Hvis en skal sikre samvirke på tvers av ulike
systemer er det helt essensielt å kunne raskt og automatisk sjekke at
tjenestegrensesnittet oppfører seg som forventet.  Jeg håper andre som
lager sin utgave av tjenestegrensesnittet vi bruke dette verktøyet,
slik at vi tidlig og raskt kan oppdage hvor vi har tolket
spesifikasjonen ulikt, og dermed få et godt grunnlag for å gjøre
spesifikasjonsteksten enda klarere og bedre.&lt;/p&gt;

&lt;p&gt;Dagens beskrivelse av Noark 5 Tjenestegrensesnitt er et svært godt
utgangspunkt for å gjøre virksomhetens arkiv til et dynamisk og
sentralt arbeidsverktøy i organisasjonen.  Blir du med å gjøre den
enda bedre?&lt;/p&gt;
</description>
        </item>
        
        </channel>
</rss>