"use strict";(self.webpackChunk_toloka_portal_gatsby_renderer=self.webpackChunk_toloka_portal_gatsby_renderer||[]).push([[6997],{89393:function(e,s,t){t.r(s),t.d(s,{default:function(){return D}});var i=t(74533),r=t(88586),n=t(37990),o=t(52893),a=t(93252),l=t(51512),h=t(25109),c=t(4511),d=t(7291),x=t(92033),u=t(46237),j=t(33543),p=t(88709),f=t(11467),m=t(3468),g=t(1532),b=t(66924),y=t(8096),w=t(3782),k=t(80207),v=t(74325),I=t(9418),T=t(39023),F=t(28384),A=t(82700),S=t(67911),C=t(85893);function D(){return(0,C.jsxs)(C.Fragment,{children:[(0,C.jsx)(o.q,{og:{img:"https://tlk-infra-front.azureedge.net/portal-static/images/knowledgebase/instructions/og/share-img.jpg",title:"Instructions",description:"What seems obvious to you might not be clear to everyone. Write concise and comprehensive instructions."}}),(0,C.jsx)(i.n,{}),(0,C.jsxs)(r.i,{headerPadding:!0,children:[(0,C.jsx)(n.h,{defaultBackground:"dark"}),(0,C.jsx)(l.w,{offset:40}),(0,C.jsxs)(h.L,{overflow:"inherit",children:[(0,C.jsx)(u.D,{level:1,children:"Instructions"}),(0,C.jsxs)("p",{children:["What seems obvious to you might not be clear to everyone.",(0,C.jsx)(m.p.Desktop,{children:(0,C.jsx)("br",{})}),"Write concise and comprehensive instructions."]}),(0,C.jsx)(l.w,{offset:40}),(0,C.jsxs)(x.J,{withoutShareLink:!0,noBottomBorder:!0,toc:[{url:"#examples",title:"Examples"},{url:"#structure-is-key",title:"Structure is key"},{url:"#tips",title:"Tips"}],form:(0,C.jsx)(d.v,{text:"Subscribe to Toloka News",inputPlaceholder:"Enter your email",button:{view:"action",text:"Subscribe",size:"l"},sendingData:{address:"/api/sender/subscribe",listId:"0ASPRWP3-H6V"},successText:"Thank you for subscribing"}),children:[(0,C.jsx)(f.V.Video,{isFrame:!0,src:"https://www.youtube.com/embed/jR64riw3L48",hasBorder:!0}),(0,C.jsx)(l.w,{offset:40}),(0,C.jsx)(S.A,{maxItemsInRow:2,inLine:!0,list:[{icon:(0,C.jsx)(b.n,{}),text:"Crowd contributors (Tolokers) have a variety of backgrounds, so don't assume that your task makes sense to everyone. The quality of the instructions will directly affect the quality of the results."},{icon:(0,C.jsx)(b.n,{}),text:"Even when the task is poorly designed, clear and comprehensive instructions may save it and provide the help Tolokers need."},{icon:(0,C.jsx)(b.n,{}),text:"Tolokers look at the instructions when selecting tasks. Most people avoid tasks with poor instructions. If your instructions are easy to follow, more people will choose your task and labeling will go faster."}]}),(0,C.jsx)(l.w,{offset:40}),(0,C.jsx)(f.V.Line,{}),(0,C.jsx)(l.w,{offset:60}),(0,C.jsx)(u.D,{level:2,styleAs:4,id:"examples",children:"Examples"}),(0,C.jsx)(j.M,{noSidePaddings:!0,shouldTabsChangeView:!1,items:[{title:"Image classification"},{title:"Bounding boxes"},{title:"Text classification"}],render:function(e){var s=e.activeTab;return[(0,C.jsxs)(C.Fragment,{children:[(0,C.jsx)(f.V.Image,{imageId:"1652949594289356-9155313194995914454"}),(0,C.jsx)(l.w,{offset:20}),(0,C.jsx)(g.l,{noSidePaddings:!0,noAlignCenter:!0,fisrtColumn:(0,C.jsxs)(C.Fragment,{children:[(0,C.jsxs)("p",{style:{display:"flex"},children:[" ",(0,C.jsx)(b.n,{})," ",(0,C.jsx)("span",{children:"  Good instructions"})]}),(0,C.jsx)("p",{children:"In the task, you'll see photos of different people. You need to look at the picture and decide whether you can see the shoes that the person is wearing."}),(0,C.jsxs)("p",{children:[" ",(0,C.jsx)("b",{children:"How to do the task"}),(0,C.jsx)("br",{}),"Look at the image carefully. Choose one of the answer options."]}),(0,C.jsxs)("p",{children:["If you can see shoes in the picture, choose"," ",(0,C.jsx)("b",{children:"Yes"}),". If you can't see shoes in the picture, choose ",(0,C.jsx)("b",{children:"No"}),". If there is no picture or if there is an error, choose",(0,C.jsx)("br",{}),(0,C.jsx)("b",{children:"Loading error."})]}),(0,C.jsxs)("p",{children:["Click the image to enlarge it and view it better. If the image is sideways or upside down, use the ",(0,C.jsx)("b",{children:"Rotate"})," button.",(0,C.jsx)("br",{}),"Skip any tasks where more than half of the images didn't load.",(0,C.jsx)("br",{}),"If you are using a desktop computer or laptop, use the hotkeys 1, 2, 3, and arrows."]})]}),secondColumn:(0,C.jsxs)(C.Fragment,{children:[(0,C.jsxs)("p",{style:{display:"flex"},children:[" ",(0,C.jsx)(y.S,{})," ",(0,C.jsx)("span",{children:"  Bad instructions"})]}),(0,C.jsx)("p",{children:"Classify the photographs that you see into two categories; those in which people are wearing shoes and in which they aren't."})]}),order:{desktop:"default",mobile:"default"}})]}),(0,C.jsxs)(C.Fragment,{children:[(0,C.jsx)(f.V.Image,{imageId:"1652949928922292-290992134900082408"}),(0,C.jsx)(l.w,{offset:20}),(0,C.jsx)(g.l,{noSidePaddings:!0,noAlignCenter:!0,fisrtColumn:(0,C.jsxs)(C.Fragment,{children:[(0,C.jsxs)("p",{style:{display:"flex"},children:[" ",(0,C.jsx)(b.n,{})," ",(0,C.jsx)("span",{children:"  Good instructions"})]}),(0,C.jsx)("p",{children:"1. Outline each traffic light with a separate bounding box (rectangle)"}),(0,C.jsx)("p",{children:"2. Correct:"}),(0,C.jsx)(f.V.Image,{imageId:"1652950080089291-13447422475486683385"}),(0,C.jsx)("p",{children:"3. Incorrect:"}),(0,C.jsx)(f.V.Image,{imageId:"1652950130302730-7718227742705201175"})]}),secondColumn:(0,C.jsxs)(C.Fragment,{children:[(0,C.jsxs)("p",{style:{display:"flex"},children:[" ",(0,C.jsx)(y.S,{})," ",(0,C.jsx)("span",{children:"  Bad instructions"})]}),(0,C.jsx)("p",{children:"Outline the traffic lights in the photos with bounding boxes. Assignments with incorrectly outlined traffic lights will be rejected and not be paid."})]}),order:{desktop:"default",mobile:"default"}})]}),(0,C.jsxs)(C.Fragment,{children:[(0,C.jsx)(f.V.Image,{imageId:"1652950178843970-5793987972208321166"}),(0,C.jsx)(l.w,{offset:20}),(0,C.jsx)(g.l,{noSidePaddings:!0,noAlignCenter:!0,fisrtColumn:(0,C.jsxs)(C.Fragment,{children:[(0,C.jsxs)("p",{style:{display:"flex"},children:[" ",(0,C.jsx)(b.n,{})," ",(0,C.jsx)("span",{children:"  Good instructions"})]}),(0,C.jsx)("p",{children:"It's important that all the text on our website is grammatically correct. Help us filter out texts with errors."}),(0,C.jsxs)("p",{children:[(0,C.jsx)("b",{children:"How to do the task "}),(0,C.jsx)("br",{}),"Read the text carefully.",(0,C.jsx)("br",{}),"Determine if there are any errors in it, such as spelling, punctuation, or stylistic errors.",(0,C.jsx)("br",{}),"When in doubt, use dictionaries or check lexico.com."]}),(0,C.jsxs)("p",{children:["If there are no errors in the text, select ",(0,C.jsx)("b",{children:"No"}),".",(0,C.jsx)("br",{})," If there are errors in the text, select"," ",(0,C.jsx)("b",{children:"Yes"}),".",(0,C.jsx)("br",{}),"And specify the error type: Spelling, Punctuation or Stylistic.",(0,C.jsx)("br",{}),"If there are various errors, select multiple options."]})]}),secondColumn:(0,C.jsxs)(C.Fragment,{children:[(0,C.jsxs)("p",{style:{display:"flex"},children:[" ",(0,C.jsx)(y.S,{})," ",(0,C.jsx)("span",{children:"  Bad instructions"})]}),(0,C.jsx)("p",{children:"Read the text and classify it according to whether it is grammatically correct. If it's not correct specify the type of error: spelling, punctuation or stylistic."})]}),order:{desktop:"default",mobile:"default"}})]})][s]}}),(0,C.jsx)(l.w,{offset:40}),(0,C.jsx)(f.V.Line,{}),(0,C.jsx)(l.w,{offset:60}),(0,C.jsx)(u.D,{level:2,styleAs:4,id:"structure-is-key",children:"Structure is key"}),(0,C.jsxs)("p",{children:["If the instructions aren't structured enough, they are hard to understand. We suggest the following structure:"," "]}),(0,C.jsx)(S.A,{maxItemsInRow:2,inLine:!0,list:[{icon:(0,C.jsx)(w.W,{}),text:(0,C.jsxs)(C.Fragment,{children:[(0,C.jsx)("b",{children:"Introduce the goal"})," ",(0,C.jsx)("br",{}),"How will the data be used? What products will it influence? Even a brief description makes Tolokers care more about the task and helps them make decisions in complicated cases."]})},{icon:(0,C.jsx)(k.Z,{}),text:(0,C.jsxs)(C.Fragment,{children:[(0,C.jsx)("b",{children:"Define the rules"})," ",(0,C.jsx)("br",{}),"Who gets access to the task? Is there a training session? Which quality level is acceptable? Are there any bonuses? Tolokers prefer predictable projects with clear arrangements. Plus, knowing about quality control and extra rewards will motivate many of them to perform better."," "]})},{icon:(0,C.jsx)(v.W,{}),text:(0,C.jsxs)(C.Fragment,{children:[(0,C.jsx)("b",{children:" Clarify technical issues"})," ",(0,C.jsx)("br",{}),"If the task requires special settings on the Toloker's computer or smartphone, provide clear instructions about that. Remember that Tolokers have varying levels of technical ability."," "]})},{icon:(0,C.jsx)(I.K,{}),text:(0,C.jsxs)(C.Fragment,{children:[(0,C.jsx)("b",{children:" Explain the task interface"})," ",(0,C.jsx)("br",{}),"If the task has hotkeys, make sure to list them. Optionally add a screenshot that highlights the buttons and tools. Skip this step if the task has a simple interface."," "]})},{icon:(0,C.jsx)(T.J,{}),text:(0,C.jsxs)(C.Fragment,{children:[(0,C.jsx)("b",{children:" Describe the steps"})," ",(0,C.jsx)("br",{}),"Write a step-by-step description of the task scenarios the Tolokers might go through. We strongly recommend that you try out some tasks while writing the instructions. You might come across unusual cases that you weren't aware of."," "]})},{icon:(0,C.jsx)(F.p,{}),text:(0,C.jsxs)(C.Fragment,{children:[(0,C.jsx)("b",{children:"Add some examples"})," ",(0,C.jsx)("br",{}),"Real-life examples are necessary and should illustrate all possible scenarios."," "]})},{icon:(0,C.jsx)(A.i,{}),text:(0,C.jsxs)(C.Fragment,{children:[(0,C.jsx)("b",{children:" Answer questions"}),(0,C.jsx)("br",{}),"Add a FAQ with important hints that don't fit in the sections above and update it later with questions submitted by Tolokers. A small glossary is always a good idea, too."]})}]}),(0,C.jsx)(l.w,{offset:40}),(0,C.jsx)(f.V.Line,{}),(0,C.jsx)(l.w,{offset:60}),(0,C.jsx)(u.D,{level:2,styleAs:4,id:"tips",children:"Tips"}),(0,C.jsx)(u.D,{level:5,children:"Structure"}),(0,C.jsxs)("p",{children:["  •  The instructions shouldn't be longer than 2 screens. If they are, this might mean the task needs to be decomposed.",(0,C.jsx)("br",{}),"  •  There shouldn't be more than 3 heading levels within the task instructions.",(0,C.jsx)("br",{}),"  •  There shouldn't be more than 7 subheadings on each level."]}),(0,C.jsx)(u.D,{level:5,children:"Text"}),(0,C.jsxs)("p",{children:["  •  Each paragraph should cover a single topic. Each sentence should cover a single point.",(0,C.jsx)("br",{}),"  •  If you need to use special terms, define them when first mentioned and use them consistently. If there are a lot of terms, a small glossary might help.",(0,C.jsx)("br",{}),"  •  Avoid slang and professional jargon, even if your colleagues use it every day.",(0,C.jsx)("br",{}),"  •  Avoid placing extra remarks in parentheses, because they tend to overload the text. If the remark is valuable, it's worth adding a separate sentence."]}),(0,C.jsx)(u.D,{level:5,children:"Formatting"}),(0,C.jsxs)("p",{children:["  •  Use only as much formatting as needed to highlight the key points. Too much bold or italic makes it difficult to focus on what's actually important.",(0,C.jsx)("br",{}),"  •  Lists are always good.",(0,C.jsx)("br",{}),"  •  So are tables."," "]}),(0,C.jsx)(u.D,{level:5,children:"Illustrations"}),(0,C.jsxs)("p",{children:["  •  Don't add pictures just for the sake of having pictures. Too many illustrations will be distracting and make it harder to understand.",(0,C.jsx)("br",{}),"  •  If there's a real need to add a lot of illustrations, it's better to hide them in an expandable section."," "]}),(0,C.jsx)(l.w,{offset:40}),(0,C.jsx)(f.V.Line,{}),(0,C.jsx)(l.w,{offset:60}),(0,C.jsxs)("p",{children:["In Toloka, instructions can be formatted using a visual editor or HTML markup. Learn more about creating and editing this section in the"," ",(0,C.jsx)(c.r,{href:"/docs/guide/concepts/instruction.html",target:"_blank",children:"docs."},1)]})]})]}),(0,C.jsx)(l.w,{offset:40}),(0,C.jsx)(a.$,{}),(0,C.jsx)(p.f,{})]})]})}}}]);