1. The document describes a training on using VocBench 1.1 to edit the BIOTECH glossary. 2. It outlines the editorial workflow and roles in VocBench including term editors, validators, and publishers. 3. Exercises are provided for attendees to practice creating, editing, and validating concepts and terms in their assigned languages.

1. Editing the BIOTECH glossary with VocBench 1.1 Training FAO Rome, June 20-21, 2011 Day 1 Caterina Caracciolo Caterina.caracciolo@fao.org 1

2. Objectives of the course Enable editors to maintain the biotech glossary using VocBench 2

3. Topics for today User roles and workflow Managing concepts, terms, definitions of the BioTech glossary 3

4. Topics for tomorrow Validation of changes in glossary New web interface of glossary 4

5. VocBench 5

7. supports distributed collaboration

8. organized in an editorial workflow

9. Supports management of multilingual data

10. Export data as SKOS, SQL ottimo,

11. 7 1 5 4 5 ottimo, 2 3 5

13. 9 Basic terminology Glossary entry = concept Entry title = term, or concept label

15. E creates an entry in EN

16. Validation

17. V validates it and approves it for translation

18. Editing

19. Translations into Chineese, Arabic, …

20. Validation and Publishing

21. P validates everything and publishes10

23. R creates concept in RU, EN translation

24. Validation, Publishing

25. Editing

26. Translations into A, C, …

27. Validation, Publishing

28. Editing

29. More translations11

30. 12 Sandbox version for training There, you can do anything! Real data will not be affected

32. accessible from inside VB, link Help

33. These slides

35. Email to any of us14

36. VocBench 15

37. 16 Managing the glossary in VB An entry in the glossary is a concept, which is titled by means of a term in a given language In any language, a concept must have one primary title, called preferred term Other titles, if any, are non-preferred Preferred titles are used to “call” concepts – see Concept Hierarchy Area in VB

38. 17 Managing the glossary in VB Concepts have definitions, which may be available in any languages A concept may be in a relation with another concept ottimo,

39. 18 Example ottimo,

40. 19 Accessing the VB You need: A User account, a role, a data set: ottimo,

42. Editing -> Validation -> Publication

44. 22 Your roles in this training For training purposes, each of you is given a user account, with possibility of playing any role in the workflow

45. 23 Exercise 0 Go to VB 1.2 Sandbox http://202.73.13.50:55481/vocbenchv1.2i/ FAO page where you can always find pointers to latest VB versions http://aims.fao.org/website/The-VocBench/sub You can get to the same FAO page by searching for “FAO AIMS VocBench” You may want to bookmark the URL

47. Chose role Term Editor

49. 26 This is what I see ottimo,

51. In what language do you see the concepts?

52. Do you see some warning saying “No term available in selected language”?

53. What color?

56. Different users may have different languages shown

57. Note the difference between:

58. The language(s) that you may edit

59. The language(s) that you can visualize

61. Assigned by Administrator, Publisher

62. You can request languages from Preferences -> Pending language request.

63. Language for content display

64. You can chose from button Content Language

66. 32 You can edit your Preferences ottimo,

69. Compare with the languages you have granted right now

70. Then go to your Preferences, and request the one(s) missingYour requests will be approved during our next coffee break 

72. For example, if you normally translate from English to Arabic, you need to visualize/edit Arabic, and visualize English

74. Go to:

75. Control panel -> Regional and Language options -> keyboards and languages -> change keyboardottimo,

76. Editorial workflow 37

79. Validation by senior editors

81. Determines what the user may or may not do in a given moment

82. Rights = permission to execute actions

83. Associated to roles

84. e.g. a term editor may add terms

85. Status = status of an element in a workflow

86. An element may be a concept, a term, …

87. Status may be draft, published, … ottimo,

88. Roles in a workflow Editors Validators Publisher Creates new entries Add definitions Accept or rejects changes Edit entry title or definition Decides what goes public Establish relations between entries Revise relations Propose deletion 40

90. Validators too may be specialized by language and area(s)

93. Create/edit/delete/revise terms and definitions for concepts in the language assigned

94. Created/edited by any editor

97. Can you read the table?

98. Click on the concept name

100. Log in and subscribe a RSS feed (link available in top stripe of the interface)

101. Then you will get notifications without having to be logged in

102. Notification can be via:

103. Email

104. Your browser

106. This is not a problem with AGROVOC, but it probably is with the Biotech glossary

108. The others see what has happened

109. Now do it by searching

112. E.g. creation of a new concepts, revision of a definition, deletion of a term

113. Validation actions are done in section Validation

114. Validators are typically domain experts who ensure quality of the content

116. Publisher 53

118. May also create and edit relationships between concepts

119. Approve new user accounts, grant rights on languages and data sets

124. Pink

125. A proposal of deletion makes the element get status Proposed Deprecated

126. Grey

128. Red

129. If the editing consists in a suggestion of deletion, the status is Proposed Deprecated

130. Grey ottimo,

132. Green

133. Validators may also reject change, then:

134. The element goes back to previous status

136. Published

137. Element approved by a publisher

138. Deprecated

139. Element discarded

140. Kept for backward compatibility

142. In which color does it appear?

144. Now, in which color does the concept appear?

146. What is the meaning of the error message you get?

147. Observe the new color of the concept, and the color of its terms

149. What result do you get?

153. Because preferred terms are used for display in concept hierarchy!

158. May be added either when creating a concept (to provide labels to the concept), or later on

161. For each definition, a source and its URL must be given

162. Right now there is no authomatic control on the URL, so be careful!ottimo,

164. A definition may be translated into several languages

165. Source and URL are for Definition (not for its translations)ottimo,

166. 76 Sources of definitions Currently you can chose among: FAOTERM NAL WIKIPEDIA MeSH Other Book Journal Article AGROVOC WordNet ottimo,

169. You have 10 minutes

170. This is not a race! Our goal is that you become confident with the tool, and suggest us where and how to improve it! ottimo,

171. 79 More information about a concept Can be specified in the corresponding tabs: Terms Definitions Note Attribute Relationship History Image Hierarchy ottimo,

173. These notes are not part of Biotech Glossaryottimo,

174. 81 More information about a concept Can be specified in the corresponding tabs: Terms Definitions Note Attribute Relationship History Image Hierarchy ottimo,

176. You may find interesting the notion of subvocabulary

177. A way to create sublists of conceptsottimo,

180. Many relationships are available

181. For the Biotech Glossary, it is recommended to use only Has related concept

182. Very general, like “see also”ottimo,

184. Search for all pairs of concepts linked by relation “Has related concept”

185. How many have you found?

186. Click on one of the related concepts

187. If concept A is realted to concept B, is it true also teh opposite?

190. Automatically generated by VBottimo,

191. 90 History ottimo,

192. 91 More information about a concept Can be specified in the corresponding tabs: Terms Definitions Note Attribute Relationship History Image Hierarchy ottimo,

194. Currently, the glossary does not include images

196. 94 Hierarchy ottimo,

197. 95