Arkitekturverksted
1. Velkommen!
Velkommen! Dette er en wiki som i utgangspunktet er opprettet som en prosjektwiki for arkitekturdokumentasjon i et migreringsprosjekt for Altinn Melding (Altinn Correspondance) og Altinn Formidling (Altinn Broker), med oppstart våren 2023.
2. Om denne wiki-løsningen
Selve Wiki-løsningen er inntil videre å oppfatte som et eksperiment. Løsningen bygger på Antora, som benytter Asciidoc-formatet. Asciidoc likner Markdown, men inneholder noen mer avanserte muligheter som kan være nyttige i større bøker eller samarbeidsprosjekter.
Mye av innholdet i denne wiki-en er generert via script i arkitekturverktøyet Archi, men løsningen tillater også manuell innholdsproduksjon i andre verktøy.
Se også publiserte Archi-modeller (html) og nedlastbar Archi-modell (master). Du kan gjøre endringer og tillegg i din versjon av Archi-modellen, og spille dette tilbake som forslag til oppdatering av mastermodellen.
3. Samarbeid om innholdsproduksjon i Archi
Det er lagt opp til at flere skal kunne samarbeide om innholdsproduksjonen. Dette kan gjøres på to måter:
-
Ta utgangspunkt i en eksport av hele eller deler av Archi-modellen (mastermodellen). Endringer og tillegg kan importeres tilbake til mastermodellen, basert på gjenkjenning av globalt unike identifikatorer for alle objekter, Dette gjøres av noen med spesielt ansvar for å vedlikeholde mastermodellen. Ved import kan/bør det sjekkes og ryddes opp i duplikater, dvs. objekter med ulik ID, men samme navn. Det er ønskelig at navning av objekter er konsistent, slik at ikke flere ulike konsepter har samme navn. En kan eventuelt merke innhold med namespace.
-
Collaboration-plugin i Archi. Anbefales inntil videre ikke, fordi det erfaringsmessig er vanskelig å få til å fungere godt med flere brukere (bugs, rettighetsstyring). Kanskje rundt neste sving?