We have three platforms where we discuss or document our annotation work
We have three platforms where we discuss or document our annotation work:
- Slack for discussing vocabulary and reporting issues with the annotation tools
- Confluence for documenting guidance and reporting vocabulary issues
- JIRA where vocabulary issue tickets are logged and software development work is tracked
Anyone working on LinkedData should have access to these tools
Slack
What do we use Slack for?
- to communicate directly with each other or in groups, either written or by calling
- to post queries and suggestions in the #annotation channel
- to share files and posts
- we post udpates on annotation guidance or 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
What do we use Confluence for?
- storing our guidanace documents
- creating spaces and pages for keeping notes
- requesting terms
CRG Space
- 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.
Annotation Guidance
- Annotation Knowledge Base is where we store 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
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.
