Blog

Confluence-parhaat käytännöt: 10 nopeaa vinkkiä Confluence-ympäristösi ylläpitoon

APR 12, 2018

Menestyvät tiimit osaavat hyödyntää oikeaa yhdistelmää ihmisiä, prosesseja ja teknologiaa menestyäkseen.

Eficode is the leading DevOps company in Europe, driving and building the future of software development across 10 countries, with 500+ experts in DevOps and sustainable software development. Our Eficode ROOT managed DevOps platform provides centralized access control and real-time visibility of project status, quality, and performance that integrates with 50+ of your preferred tools, including the Atlassian Stack and open-source systems like Jenkins and Kubernetes.

Wikeistä on nopeasti tullut yksi menestyvien tiimien keskeisistä teknologioista ympäri maailmaa. Ne tarjoavat reaaliaikaista tietoa helposti saataville rajattomalle määrälle ihmisiä missä tahansa, lähes millä tahansa laitteella. Wikien avulla on myös helppo edistää yhteistyötä. Ne tarjoavat keskitetyn ja versionhallinnan piirissä olevan dokumenttivaraston, mahdollistavat monipuolisen sisällön muokkauksen ja tehostavat viestintäprosesseja.

Näin hyödyllisen teknologian käyttöönottoon liittyy luonnollisesti myös riskejä. Wikit eivät ole poikkeus: niihin voi kertyä päällekkäistä tai vanhentunutta sisältöä, mikä vaikeuttaa navigointia ja turhauttaa käyttäjiä.

Atlassian Confluence on erittäin tehokas wiki-työkalu, mutta suuren voiman mukana tulee suuri vastuu. Tämän kirjoituksen tavoitteena on tarjota 10 nopeaa Confluence-parasta käytäntöä, joiden avulla saat:

  • Parempi ymmärrys siitä, MIKSI Confluence-ympäristön organisointi ja hallinta ovat tärkeitä

  • Mahdollisuuden vaikuttaa välittömästi Confluence-ympäristösi selkeyteen tehtävänimikkeestä, toimialasta tai kokemustasosta riippumatta

  • Perustan Atlassian Confluencen monipuolisten toimintojen hyödyntämiseen niin, että ne tukevat tiimejäsi eivätkä hidasta niiden työtä

Haluatko lisää? Tutustu Clearvisionin (nykyisin osa Eficodea) Confluence-koulutusten valikoimaan.

1. Kirjoita ensin, muotoile vasta sitten

Sisältöä luotaessa kannattaa aluksi käyttää vain otsikoita ja taulukoita. Ne tuovat perusrakennetta ja järjestystä ajatusten purkuun hidastamatta tiedon kirjaamista sivulle.

Unformatted

Oma nyrkkisääntöni on, etten tee lisämuotoiluja ennen kuin vähintään 75 % sisällöstä on kirjattu. Sisällön viimeistelyyn voi kuulua esimerkiksi:

  • Tekstin muotoilu (lihavointi, kursivointi, alleviivaus)

  • Hymiöiden tai symbolien lisääminen

  • Visuaalisten tai ulkoasuun liittyvien makrojen, kuten sisällysluettelon, lisääminen

  • "Vinkki"-makro

2. Lisää metatietoja spaceihin

Tämä voi kuulostaa työläältä, mutta ajattele asiaa näin: lisäämällä yksinkertaisen kuvauksen voit estää tiedon tahattoman eriytymisen käyttäjiltä, jotka eivät tunne Confluence-ympäristöäsi yhtä hyvin.

Descriptions

Hyödynnä myös space-kategorioita. Niiden avulla tiedot voi ryhmitellä helposti ja ennen kaikkea löytää ne helposti Confluence-instanssisi kasvaessa.

Categories

Tämä esimerkki space-kategorioiden hyödyntämisestä johdattaa vinkkiin numero 3…

3. Käytä "Space List" -makroa

Voit lisätä tämän makron mille tahansa sivulle. Sen avulla käyttäjä voi suodattaa space-luetteloa dynaamisesti yläreunan välilehtien kautta: Kaikki, Suosikit, Uudet tai KATEGORIAN mukaan.

Kuten alla näkyy, avattavan valikon kategoriat vastaavat edellisessä kuvakaappauksessa spaceihin lisättyjä kategorioita.

Spaces

4. Yhdenmukaista dokumentaatio sivumallien avulla

Sivumallien avulla voit luoda helppokäyttöisiä e-lomakkeita, jotka määrittävät selkeästi kaikki kerättävät tiedot. Ne sisältävät ohjetekstiä (korostettu alla harmaalla), kun käyttäjä luo tai muokkaa sivua ensimmäisen kerran.

Custom

5. Yhdenmukaista hierarkiat kopioimalla sivupuita

Toinen tapa yhdenmukaistaa luotua tietoa on hyödyntää Confluence 6.0:ssa käyttöön tullutta "Copy Page Tree" -toimintoa. Sen avulla voit kopioida sivun sekä kaikki sen alasivut haluamaasi kohteeseen Confluencessa.

Tässä on ohjelmistokehitystiimille esimerkki käyttötapauksesta:

  • Jokaiselle uudelle tuotteelle, jonka kehittäminen annetaan tiimisi tehtäväksi, luodaan uusi työtila.

  • Jokaiseen uuteen tuotetyötilaan on luotava sama sivukokonaisuus, kuten tiimitiedot, vaatimukset ja mockupit – kukin omalle sivulleen.

  • Sen sijaan, että loisit sivuhierarkian manuaalisesti uudelleen sivu kerrallaan, voit kopioida sivupuun yhdestä työtilasta toiseen ja muokata tietoja tarpeen mukaan.

Voit viedä tämän vielä pidemmälle luomalla Skeleton-työtilan, joka sisältää yhden tai useamman sivuhierarkian ilman tuotekohtaisia tietoja. Näin voit käyttää ja kopioida niitä milloin tahansa toiseen työtilaan. Tällöin tietoja tarvitsee vain lisätä sen sijaan, että niitä lisättäisiin ja poistettaisiin. Tämä vähentää riskiä kopioida sivujen välillä epäolennaista tai yksityistä sisältöä.

6. Lisää sivuille tunnisteita

Tunnisteet toimivat samalla tavoin kuin hashtagit Twitterissä tai Instagramissa. Kun lisäät sivulle yhden tai useamman tunnisteen tai tagin, löydät sisällön myöhemmin helpommin suodattamalla hakutuloksia ennalta määritetyn tunnisteen perusteella.

Kun napsautat tunnistetta, näet kaiken sillä merkityn sisällön työtila- ja sivukohtaisten käyttöoikeuksien mukaisesti.

7. Käytä Content Report Table -makroa

Content Report Table -makro näyttää luettelon Confluencen sisällöstä ennalta määritetyn suodattimen perusteella.

Content

Tässä kuvakaappauksessa Content Report Table -makro (vasemmalla) on määritetty näyttämään kaikki sivut, joilla on jokin Labels List -kohdan (oikealla) alla näkyvistä tunnisteista.

8. Yhdistä Page Layout- ja Panel-makrot

Lisäämällä sivun asetteluun sarakkeita sekä mukauttamalla paneelien värejä, reunuksia ja otsikoita voit luoda visuaalisesti miellyttäviä sivuja, joiden tiedot ovat helppoja hahmottaa kaikille käyttäjille.

Combine Layout

9. Taulukoiden laajentaminen ja supistaminen

Tässä näet matriisin, jonka loin tämän artikkelin jäsentämiseksi. Jos haluan nähdä vain perustiedot, kuten luettelon kymmenestä vinkistä, taulukon supistettu näkymä on ihanteellinen.

Expanding And Collapsing

Voin kuitenkin tarkastella minkä tahansa dian yksityiskohtaisia tietoja nopeasti laajentamalla kohdan Slide Images, Slide Talking Points tai molemmat.

Expanding And Collapsing

10. Ota käyttöön virallinen hallintamalli

  1. Määritä selkeästi, mitä työtila tarkoittaa – tarkastele ensin organisaatiorakennettasi ja etene siitä tuotteiden tai toimintoryhmien pohjalta.

  2. Yhtenäistä työtilojen ja sivujen nimeämiskäytännöt

  3. Ota käyttöön virallinen arkistointikäytäntö sekä yksilö- että sivustotasolla – nimeä informaatioarkkitehti ja sovi säännöllisistä tapaamisista. Pieni ylläpitotyö etukäteen auttaa välttämään suuret siivousurakat myöhemmin.

  4. Dokumentoi hallintastandardisi – kirjaa ne suoraan Confluenceen!

Näillä Confluencen parhaiden käytäntöjen vinkeillä olemme vasta raapaisseet pintaa – voit tehdä paljon muutakin, jotta Confluence toimii sinulle ja tiimeillesi. Atlassian Authorized Instructorina Clearvision tarjoaa monipuolisia ja joustavia Confluence-koulutuksia sekä koulutusta muihin Atlassianin tuotteisiin kaikentasoisille käyttäjille. Ota yhteyttä jo tänään ja kysy lisää!

  • Atlassian

Subscribe to our newsletter