아틀라시안 컨플루언스 (Atlassian confluence) Wiki Jira draw 사용하는 방법

안녕하세요

앵과장입니다.

 

회사 규모에 따라 다르겠지만 많은 회사에서 컨플루언스를 이용해서 wiki, jira, 그리고 Git 사용을 위한 Bitbucket 을 사용합니다.

최근 재택 생활을 많이 하다보니 커뮤니케이션 비용을 최대한 줄이기 위해서 공유할때 Wiki를 잘정리해서 전달하는것도 필요합니다.

 

슬기로운 회사생활에서 Wiki 를 작성하거나 JIra를 활용하는데 알아두면 좋은 방법들을 정리해보도록 하겠습니다.

 

개발을 잘하는것도 중요하지만 일머리가 있는 개발자가 회사일처리하는데 있어서 중요하다는점 잊지마세요!!

 

자주 사용하는 Wiki 플러그인 기능

 

Jira

jira차트

펼치기

코드 블럭

하위 페이지 표시

가로줄

 

WIKI에 JIRA Dashboard 표현하기

 

JIRA에서 System Dashboard 를 통해서 현재 나에게 할당된 JIRA 항목들을 확인할수 있습니다.

 

Jira에 관리되고 있는 기능을 좀더 한눈에 보기위해서는 다양한 방법이 있지만 WIki에 플러그인을 통해서 아래처럼 

2가지의 표현하는 레이어를 추가할수 있습니다.

 

Wiki 에 플러그인 추가

 

다른 매크로 > 'jira' 단어로 검색시 Jira 와 Jira차트 2가지항목 확인 가능합니다.

 

JIRA Query

Jira Query 검색해보시면 아래처럼 관련내용 확인가능합니다.

JQL 이라고 하고 jira issue 검색하기위한 아틀란시아에 제공하는 언어입니다.

Sql문법과 비슷하니 약간만 알면 손쉽게 표현가능합니다.

https://www.lesstif.com/jira/jql-jira-query-language-jira-issue-1-18220188.html

JQL(JIRA Query Language) 로 JIRA Issue(지라 이슈) 검색하기 #1

샘플A

프로젝트명이 '장애대응'으로 시작

And 조건으로 assignee in (아이디) 여러 아이디 in 조건

and 조건으로 날짜 검색 추가

and 조건으로 상태 추가

order by asc 정렬 추가 

project = 장애대응 AND assignee in (lswtee, sunu1989, jss83, leeleele)     AND (       (updatedDate >= startOfWeek(-12) and createdDate >= startOfWeek(-12) AND status NOT IN ('OPEN', 'IN PROGRESS','REOPENED') AND resolutiondate >= -4w)       OR       (status in ('OPEN', 'IN PROGRESS','REOPENED'))     )  ORDER BY status ASC, updatedDate DESC

샘플 B

프로젝트명이 {검색하고싶은 네이밍} 으로 시작

And 조건으로 assignee in (아이디) 여러 아이디 in 조건

and 조건으로 날짜 검색 추가

and 조건으로 상태 추가

order by asc 정렬 추가 

프로젝트  = {딜관련프로젝트는 SLAB} AND assignee in ({담당자}) AND (        (updatedDate >= startOfWeek(-12) and createdDate >= startOfWeek(-12) AND status NOT IN ('OPEN', 'IN PROGRESS','REOPENED'))   OR        (status in ('OPEN', 'IN PROGRESS','REOPENED', 'TO DO') AND (labels != '미할당_딜관리개발' OR labels is EMPTY))    )  ORDER BY status ASC, updatedDate DES

 

 

JIRA 이슈 필터 삽입 플러그인

 

Wiki에서 Jira 이슈필터 선택후 이미지에서 보이는 Input Box에 JIra Query 질의하여 현재 원하는 Jira 항목을 검색한뒤 화면에 노출하는 방법입니다.

원하는 Jira Query가 완성되었다면 '표시 옵션' 선택후 원하는 항목만 표기하여 Dashboard를 완성해보시기 바랍니다.

Jira 차트 삽입

Jira 차트 삽입 플러그인도 동일하게 Jira Query 를 이용해서 원하는 항목을 검색할수 있으며 

현재 Jira 진행중인 상태 "진행중, 완료, 할일, 소계" 를 확인해볼수 있습니다.

 

해당내용은 Jira에서 상태를 커스터마이징 할수 있기때문에 회사마다 표기되는 상태값은 다를수 있습니다.

 

 

해당 Jira 플러그인 2가지를 잘활용하면 Wiki에서 팀원들에 JIra진행사항들을 확인해볼수 있습니다.

굳이 뭐하는지 궁금해하지 않아도 되고 현재 무슨일을 하고있는지 파악도 되는 회사 돌아가는 상황을 한눈에 볼수 있습니다.

 

이기능은 팀장 직책을 하게된다면 상당히 유용한 기능입니다.

팀원들한테 뭐하는지 물어보는것도 사실 미안하기도하고 껄끄럽기도 한데 이렇게하면 대략적으로 알수 있기때문입니다.

또는 개발자들에 일처리 상황을 파악해서 효율적인 일분배도 가능하게됩니다.

 

물론 JIra기반으로 일처리를 해야하겠지만 말입니다.

 

커뮤니케이션 비용을 최소화 할수 있고 일머리 잘돌아가는 개발자가 됩니다.!!

 

내용 에서 단추가와 열추가 하기

 

이미지 처럼 단 이모티콘을 누르면 단추가, 단제거 공간나누기가 가능합니다.

내용을 쓸때 화면에 구성을 하면 좀더 한눈에 보기편한 문서 나누기가 가능합니다.

 

단으로만 나눠놓으면 공간분리는 되지만 테투리는 화면에 표시되지 않기때문에 

 

패널을 구성해서 원하는 공간에 분리된 선으로도 표기가 가능합니다.

draw.io 템플릿

 

WIKI에 문서화 하다보면 시각적으로도 표현해야하는 일이 있는데 draw.io에서 시각적인 표현에 대한 레이어를 구성하면 커뮤니케이션할때 높은 퀄리티를 구성할수 있습니다.

 

https://app.diagrams.net/

Flowchart Maker & Online Diagram Software

다양한 시각적 표현이 가능하니 아키텍처나 흐름등을 표현해보세요

 

AWS 템플릿

 

aws.xml

0.00MB

구성 템플릿

diagram

0.00MB

작업했던 샘플들을 첨부합니다.

 

Wiki 문서는 최소화 하세요 
우리는 개발자 입니다. 코드로 표현하세요

회사에 위키를 잘 작성하는것도 너무 좋은방법입니다.

하지만 내정보들을 지속적으로 관리하기 위한방법으로는 블로그 만드시는것 추천드리며

정보들은 최소한에 커뮤니케이션을 위한 내용만 작성하세요

 

저도 열심히 만든적이 있는데 시간이 지나면서 이직하다보니 회사에 너무 열심히 시간쓰는것도 방법이 아닌것 같더라구요

 

가장 중요한 포인트는 질문을 최소화 할수 있는 형태로 내용을 만드시는것 추천드립니다.

 

가끔 앞뒤 없고 중간으로 시작하는 커뮤니케이션 하시는분들이 많은데 어느정도 공감이나 히스토리가 인지되고 나서는 그렇게 해도되지만 처음부터 깜빡이 없이 가는건 매너가 아니랍니다.!!