We have three platforms where we discuss or document our annotation work:
Confluence
Confluence is project collaboration software which links with JIRA.
Who has access
Every Cochrane Information Specialist or other persons who are working on PICO annotation for Cochrane should have access.
How to change your password
If for any reason you need to change your password please follow instructions provided HERE.
Your Space
Each CRG has their own Space in Confluence where they can store any documentation related to their annotation work. On the main page of this Space a form has been provide for reporting vocabulary issues.
Information on how to add new pages or edit existing ones in your Space can be found HERE.
Do NOT remove coding from HTML box when editing Space home page
CRGs can add and remove any information as they wish however it is important not to remove the coding in the HTML box as this will disable the reporting form for vocabulary issues.
Block email notifications
Blocking notifications from Confluence
Guidance for using Confluence
Creating a page
| Action | Description | |
|---|---|---|
| 1 | Click on Create in the blue menu bar at top of page to create a blank page |
|
| 2 | Click on the 3 dots beside Create to open up a list of templates - use only if you want something other than a blank page | |
| 3 | Select the template you wish to use and click on create |
|
| 4 | When page is completed click on publish |
|
Editing a page
Action | Description | |
|---|---|---|
| 1 | Go to Space home page | |
| 2 | Click on Edit at the top of the screen |
|
| 3 | Before you can structure your page you need to add a title after which the horizontal edit menu bar will be available |
|
| 4 | Vary the page layout. Here you are given options to divide the page into sections, or multiple columns. When you click on the icon a second edit menu bar will appear. |
|
| 5 | Insert macros. This is useful if you want to insert table of contents, information boxes etc. |
|
If you require more information or more advanced options click on 
at top of page.
If you have questions or would like some more information added here please contact Deirdre (dbeecher@cochrane.org)
Report a Vocabulary Issue form
Embedded on the home page of each CRG Space, is a vocabulary issue reporting form. Even though the title is Raise Preferred Vocab Term Issue, any vocabulary issue can be raised here, i.e. add a term, merge a term. Once you have completed the form and clicked on Submit the issue will be logged on JIRA (click HERE for more information). In each CRG Space, pages have been added with tables for resolved and open vocabulary issues. As the status of these issues changes these tables automatically update. Action Description Provide your name and email address. These fields are provided at the bottom of the form. This helps if we need to contact the person who submitted the request.1 Click on the button provided on your space page. 
2 Insert the term in the field provided. 
3 Select the PICO component or components for which the term is required. 4 Select the vocabulary action required. Add, Merge, etc. 5 Select your Group from the drop-down list. 
6 Add the CD number of the review. 7 
8 Click on Submit. 9 Any information that you might feel relevant to your request should be included in any of the fields provided.
Annotation Knowledge Base
This is a repository for guidance on annotation and can be found HERE.
JIRA
JIRA is used for project and issue tracking for both vocabulary and tool issues, and tool development.
Who has access
Every Cochrane Information Specialist or other persons who are working on PICO annotation for Cochrane should have access.
LDD and LDO
We have two boards LDD and LDO where we can monitor and track progress of all logged issues.
Terms requested using the Report a Vocabulary Issue form
Each request generates a JIRA ticket which in turn creates further discussion about individual terms on JIRA. If you are asked for feedback about a vocab request, you will receive an email notification from JIRA. To respond to these messages, click on the JIRA link for the vocab request within the email (rather than responding to the email). You will be prompted to enter your JIRA ID and password. You can then leave comments on the JIRA page for that request.
Open Vocabulary Issues page shows progress of JIRA tickets.
Responding to comments on my JIRA ticket term request
Sometimes more information is required from the requester and this is inserted as a comment on the the JIRA ticket that was generated for the specific request. This in turn will generate an email alert to be sent to the requester. To respond we ask that you click on the link to the ticket within the email rather than responding to the email.
| Action | Image | |
|---|---|---|
| 1 | Click on the JIRA ticket link (title of request) within the email that you receive to your email inbox |
|
| 2 | If not already logged in you will be prompted to enter your JIRA/Confluence user ID and password |
|
| 3 | Once logged in click on Comment to leave any further information that was requested by Deirdre or Lorne. Remember to alert them, insert @ before their names. When finished click on Add. |
|
Slack
This is a digital work place where you have access to two channels, #annotation and #crg-vocab-vote. We use these channels to post annotation questions, update on new developments, and help everyone with any issue they may have.
Who has access
Every Cochrane Information Specialist or other persons who are working on PICO annotation for Cochrane should have access to both channels. Please contact the Senior Metadata Specialist if you need access.
What should be posted in the annotation channel?
- comments & suggestions
- general questions about annotation issues and vocabularies
- reporting issues with the tools
Remember that posts in this channel can be viewed by all members.
Working methods
Send a private or direct message
If you wish to send a private message to one or more people use the direct message option.
- Click on + beside Direct Message at the bottom of the lefthand column
- Begin to type name of contact in the search box and the name will arrive at the top of the list beneath the search box
- Enter multiple names if you wish to create a group
- When ready click on GO
Keyboard functions for formatting messages
The message box either for sending a direct message or posting a message in a channel is not like many other standard text boxes.
use Shift Enter to create new lines in your message
to emphasize words or phrases
surround your text with *asterisks* to create bold text
for italic text use _underscores_
for quotes add angle brackets to the beginning of your message to highlight text with an indented blockquote
Chat and share your screen
Please be aware the following funtionality may not work with some browsers.
Icon | Description |
|---|---|
| At the top of screen, if you see the phone receiver icon, it means you can call the person or persons that you have selected. |
| Once on a call you can also share your screen by clicking on the screen symbol. |
