| Table of Contents | ||||
|---|---|---|---|---|
|
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
We have three platforms where we discuss or document our annotation work:
|
| Table of Contents |
|---|
| Panel | |
|---|---|
| borderColor | black |
| titleColor | black | Who has access? | Anyone who isworking on Linked Data projects |
| borderColor | Black |
|---|---|
| titleColor | black |
| title | Confluence (guidance is stored here) |
LinkedData should have access to these tools. If you do not yet have access contact Deirdre Beecher. |
Slack
What do we use Slack for?
- to communicate directly with each other or in groups
- to
- share files and posts
- to post udpates on annotation guidance
- , tool development
- and troubleshooting
What can I post to the annotation channel?
- comments & suggestions
- general questions about annotation issues
- request for help with annotations (or if you want someone to check your annotation)
- reporting issues with the tools
How do I post to the #annotation channel
- just type and hit your enter key
- to alert a particular member of the team insert @ before their name
- remember that posts in this channel can be viewed by all members
How do I send a direct (private) 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
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.
What do we use Confluence for?
- storing our guidanace documents
- creating spaces and pages for keeping notes
- requesting terms
CRG
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.
YourSpace
- Each CRG has their own Space in Confluence where they can store any documentation related to their annotation work
- - how you want to use this space is entirely up to you!
- On the main page of this Space a form has been provide for reporting vocabulary issues
- To find your Space click on
found on the blue menu bar at the top of the page, and then on Space directory to search - Information on how to add new pages or edit existing ones in your Space can be found HERE.
| Info | ||
|---|---|---|
| ||
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
| title | Expand for step-by-step guide |
|---|
Click on Create in the blue menu bar at top of page to create a blank page
Annotation Guidance
- Annotation Knowledge Base is where you can find all our guidance
Block email notifications
When changes are being made to various pages you may receive a number of unwanted email alerts. If you wish to block them please see Blocking notifications from Confluence.
JIRA
What do we use JIRA for?
- tracking software development
- logging vocabulary requests
our two boards are LDD and LDO
Editing a page
| title | Expand for a step-by-step guide |
|---|
Action
Description
| Info |
|---|
If you require more information or more advanced options click on 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.
| title | Expand for How to use the Vocabulary Issue Form |
|---|
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.
This is a repository for guidance on annotation and can be found HERE.
| HTML |
|---|
<a href="#com-atlassian-confluence">Back to Top</a> |
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.| Expand | |||||||||
|---|---|---|---|---|---|---|---|---|---|
| |||||||||
|
Requesting vocabulary terms
- 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
Search JIRA for vocabulary issues
- within JIRA it is possible to search for any requests that you have made
- you can limit your search to your name, Group, PICO etc.
The following are some examples of how to search for your requests
Search by requester/reporter name
| Expand | |
|---|---|
|
Responding to comments on my JIRA ticket term request
| |||||||||||||||||||||
|
Search by Cochrane Group
| Expand | ||||
|---|---|---|---|---|
| ||||
|
If not already logged in you will be prompted to enter your JIRA/Confluence user ID and password
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.
| HTML |
|---|
<a href="#com-atlassian-confluence">Back to Top</a> |
Chat and share your screen
Please be aware the following funtionality may not work with some browsers.
Icon
Description
|
| HTML |
|---|
<a href="#com-atlassian-confluence">Back to Top</a> |
| HTML |
|---|
<script type="text/javascript">
AJS.toInit(function(){
AJS.$('#comments-section').hide();
});
for (var i=0; i<nr_li; i++) {
// if the element has the class fom 'clasa' parameter
if(tags_li[i].getAttribute('class') == 'innerCell'){
tags_li[i].style.overflow = 'visible';
//tags_li[i].style.overflow-y= 'visible';
}
}
</script> |