Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Lösningens livscykeln - håll dokumentationen uppdaterad

Excerpt
nameLivscykel

Det är naturligtvis viktigt att dokumentationen är aktuell och korrekt. Därför ingår det i samtliga projekts och förvaltningspersonals uppgifter att rätta fel och ändra dokumentationen när lösningen ändras.

Lösningar är inte statiska utan förändras kontinuerligt. Därför är det viktigt att se dokumentationen som en del av lösningen och säkerställa att den hänger med i förändringen.

Tanken är därför att informationen ska vara levande

  • Man startar i förstudie och fyller i så djupt man kan. Här kan as-is och to-be scenarier finnas med i olika stycken. Det kan också finnas olika varianter av lösningsförslag.

  • Man utvecklar framförallt lösningsarkitekturen under projektets gång. Lösningar som förkastas flyttas till arkivsidan för att uppnå spårbarhet. I slutet av projektet kvarstår bara de implementerade lösningarna. As-is flyttas till arkivet, to-be ligger kvar men behöver ingen rubrik för “to-be”.

  • Man påbörjar förvaltningsinformationen under projektet och dokumenterar löpande så att informationen växer fram successivt som en del av lösningen.

  • Vid överlämning till förvaltning kontrolleras att deploymentdiagram och driftsinformation är korrekta.

  • Dokumentationen underhålls löpande vid normalt systemunderhåll. Kommer nya målbilder om framtida lösningar, kan det vara aktuellt att införa as-is och to-be scenarios igen.

  • Nya projekt som berör lösningen dokumenteras normalt i samma i Confluenceyta (space). Skapar man en helt ny lösning som ersätter den gamla skapar man en ny yta för den nya lösningen och arkiverar den gamla ytan när man pensionerat den gamla lösningen.

Sidornas struktur

...

nameSidstruktur

De flesta sidor har en liknande struktur. Nedan beskrivs de element som oftast ingår på en sida.

Tips! Om du skapar egna sidor kan det vara bra att utgå från en mallsida för att få med olika element på sidan.

...

Sidans namn / titel

På varje sida infogas med fördel generell sidinformation.
Sidinformationen läggs inom ett makro som heter Page properties, som gör att man kan hämta ut denna information och visa på andra sidor.

...

...

Under sidinformationen, placeras när det är tillämpligt en innehållsförteckning, här anges texten Innehållsförteckning (i formatet Normal) med fet stil. Och så infogas antingen innehållsförteckning för sidan, eller en lista över undersidor.
Efter innehållsförteckningen placeras en linje - via makrot Divider.

...

Om sidan skall innehålla innehåll, läggs detta efter stycket och linjen enligt punkt 3 ovan.

...

Om det är tillämpbart, så kan man på slutet av sidan lägga in relaterat innehåll, via makrot Content by Label. I makrot anges man vilket/vilka labels man vill innehåll skall visas för. Se till att bocka ut “Show Labels for Each Page” och “Show Space Name for Each Page”.
Se till att ha en linje - via makrot Divider ovanför Content by Label.

...

Längst ner på sidan till höger, visas eventuella Labels som är satta för sidan. Läs mer om hur man använder etiketter på Confluence hjälpsidor.

Hur man skapar en yta från mallen

Excerpt
nameSkapa en yta från mallen
  1. Skapa en ny “tom” yta (space) - se instruktion Create a blank space | Confluence Cloud | Atlassian Support

    1. Se till att namnge ytan med ett lämpligt namn på lösningen, tex applikaitonens namn

  2. Kopiera översiktssidan i mallen - https://jiragu.atlassian.net/wiki/spaces/M3

    1. Select space: välj din nya yta/space

    2. Parent page: välj sidan som heter Home på slutet för din nya yta/space

    3. Include X childe pages: bocka i detta val.

    4. Klicka på Copy.

  3. Sidorna skall ny skapas upp på ytan som pekades ut, i steg 2 ovan.