Version at: 26/04/2013, 19:07 vs. version at: 26/04/2013, 19:11
11##Introduction
22
33This article by Trang is a must-read for anyone who is serious about contributing in Tatoeba.
44
55Here is an outline of how to be a good contributor:
66
771. [Understand the context of the project](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule1)
882. [Understand how the corpus is structured](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule2)
993. [Focus on the main sentence, not the other translations](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule3)
10104. [Translate the sentence as a whole rather than as a collection of individual words](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule4)
11115. [Do not edit a sentence if, by itself, it is correct](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule5)
12126. [Do not change the language in which a sentence is written](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule6)
13137. [Make sure you are adding comments to the right sentence](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule7)
14148. [Do not add sentences from copyrighted content](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule8)
15159. [Do not annotate sentences](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule9)
161610. [Give us feedback](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule10)
171711. [Do not wait for us to code it if you can code it](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule11)
181812. [Indicate your languages in your profile](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule12)
191913. [Encourage and educate new (or even not so new) contributors](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule13)
202014. [Spread the love](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule14)
2121
2222[](http://www.blogger.com/post-edit.g?blogID=2196533844101218567&postID=5954885196540160002)
2323
2424##1. Understand the context of the project
2525
26I will (someday) write a more detailed history, but here are the basic facts you should be aware of.
27
2826* I started this project in 2006. The initiative was driven by my passion for language learning and frustration about not finding an adequate online dictionary. The project is focused on **sentences** and I insist on **sentences**. Sample sentences were (and still are) a very scarce resource. Please only add **complete sentences** if you are going to contribute.
2927* I was alone on this project for some time. It was only three years later, in 2009, that other people (all computer science students) started to help me out by coding more features.
30* Tatoeba is NOT a commercial project. We're not a company, we're not paid for doing any of this. It is is something that we're working on in our **free time**.
28* Tatoeba is NOT a commercial project. We're not a company, and we're not paid for doing any of this. It is is something that we're working on in our **free time**.
3129* To be honest, we don't exclude the possibility of starting a company someday, but that is if and only if we have an innovative, coherent and ethical business model (yeah, good luck). Having ads everywhere and driving a lot of traffic, or forcing people to pay to access the data, is out of the question.
3230
3331[](http://www.blogger.com/post-edit.g?blogID=2196533844101218567&postID=5954885196540160002)
3432
3533##2. Understand how the corpus is structured
3634
3735The corpus is structured not as a **table** but as a **graph** (in the computer science sense of the word). What does that mean? Well, imagine you had to extract part of the corpus and write it on paper. You might do something like this:
3836
3937<table><tbody>
4038<tr> <th style="text-align: left;">English</th> <th style="text-align: left;">French</th> <th style="text-align: left;">Spanish</th> </tr>
4139<tr> <td>My name is Trang.</td> <td>Je m'appelle Trang.</td> <td>Me llamo Trang.</td> </tr>
4240<tr> <td>How are you?</td> <td>Comment vas-tu?</td> <td>¿Cómo estás?</td> </tr>
4341<tr> <td>...</td> <td>...</td> <td>...</td> </tr>
4442</tbody></table>
4543
4644That's a **table** structure. There are **rows** and **columns**: a row contains sentences with the same meaning, and a column contains sentences with the same language. That's the first approach anyone might take, but that's NOT how the corpus is constructed.
4745
4846Our corpus is set up like this: *[note: diagram needs to be imported]*
4947
5048That's a **graph** structure. There are **nodes** and **edges**: each node represents a sentence, and each edge represent the link between two sentences. When two sentences are linked, they have the same meaning.
5149
5250The structure of the representation has a big effect on the way you can contribute to the corpus. One important implication of the graph structure is that you can add **multiple translations in the same language** for a specific sentence. You think there are two ways to translate a sentence and you really can't decide which would be the best? Well, just add both!
5351
5452Some other implications are pointed out below.
5553
5654
5755##3. Focus on the main sentence, not the other translations
5856
5957When you translate a sentence, you are in fact adding a **sentence** (node) and a **link** (edge) between the original sentence and your translation. The only thing you need to care about is that you are adding a proper translation to the "main sentence" (the one at the top, in larger type).
6058
6159Assume you wanted to add a Spanish translation to the English sentence "How are you?", which happens to have an existing French translation "Comment vas-tu ?" You would see the following:
6260
6361_How are you?_
6462
6563_=> Comment vas-tu ?_
6664
6765You could add _"¿Cómo estás?"_ (informal) or _"¿Cómo está usted?"_ (formal). Even better, you could add both as separate translations of the same original sentence. You should not restrict yourself to choosing an informal translation simply because one was chosen by the person who was working in French. You should only care that your translation is a proper translation of the **English sentence**: if someone had to translate your contribution back to English, _"How are you?"_ would be a possibility.
6866
6967
7068##4. Translate the sentence as a whole rather than as a collection of individual words
7169
7270We are not interested in having sentences that sound like they were written by a primitive robot that translated the individual words without regard for the sentence as a whole. We want sentences that a native speaker would really say. Translating is a very difficult task, we know. But if you are translating into your native language, you should always, always reread your translation in isolation from the original, and ask yourself if it is actually something people would say. If, for some reason, you want to add a word-by-word translation that is not what a native speaker would say, you should use the comments.
7371
7472You are allowed to translate into a language other than your own, in which case you are forgiven for not writing native-like sentences. But in this case, please add a comment or tag to request that a native speaker check your sentences and correct any mistakes.
7573
7674Tatoeba is not only about providing translations, it's also about gathering data about a language. Even if none of the sentences in a given language has yet been translated, those sentences are informative in themselves. However, they must be representative of their language.
7775
7876To put it another way, the sentences are the basic layer in the Tatoeba corpus. The links between the sentences form another layer. But the corpus should have value even without that second layer.
7977
8078
8179
8280##5. Do not edit a sentence if, by itself, it is correct
8381
8482As I mentioned in the previous section, sentences in Tatoeba have value apart from their translations. Consequently, before you modify a sentence, look at it without paying attention to its translations, and ask yourself _"Does this sentence have any spelling or grammar mistake? Does it sound weird?"_. If the answer is "No", then do NOT edit it, **leave it alone**! If one or more of the translations is incorrect, you should break the links between them (or ask someone else to do it for you), but sentences that are valid in themselves should remain unchanged.
8583
8684You may be tempted to edit a sentence so that its meaning matches all the other sentences. Or perhaps you want to turn a sentence into a word-for-word translation. But this is not a good idea. Not only does a word-for-word translation run the risk of sounding unnatural (cf. rule #4), but you're replacing data when you could be adding new data and keeping the old.
8785
8886Sometimes, a sentence may not match the original AT ALL. For instance:
8987
9088
9189
9290_My name is Trang._
9391
9492_=> Je m'appelle Trang._
9593
9694_=> Vamos a la playa._
9795
9896You notice that the Spanish sentence (which says "Let's go to the beach") has nothing to do with the English sentence.
9997
10098Perhaps you don't speak Spanish very well so you're not confident in modifying the Spanish sentence and decide to change the English sentence instead. However, then you create another problem: the French sentence won't fit the English sentence anymore...
10199
102100Perhaps you are a native Spanish speaker and are tempted to change the Spanish sentence. In this particular case, it would still be acceptable because the Spanish sentence is not linked to any other sentence. But if someone had translated that Spanish sentence into Italian, "correcting" the Spanish sentence would cause a conflict with the Italian translation.
103101
104102Then there is a problem you may have not thought of: when changing the meaning of a sentence, you are potentially erasing unique vocabulary. What if the Spanish sentence was currently the only one with "playa" in it?
105103
106104The best way to proceed in this kind of situation is to add a new Spanish translation (_Me llamo Trang_) and "unlink" the current Spanish translation. NOTE: Only "trusted users" (users with a level of advanced contributor or higher) can unlink. However, anyone can post a comment to request that a sentence be unlinked.
107105
108106
109107##6. Do not change the language in which a sentence is written
110108
111109While you should correct the language flag for a sentence if it is wrong (for instance, it is flagged as Chinese when it is in fact Japanese), you shouldn't replace, say, a Japanese sentence by a Chinese sentence with the same meaning.
112110
113111The problem is that a sentence can be associated with data, such as comments, that depend on its language. People can post comments on sentences, and the comments may be valid only because the sentence was in a certain language.
114112
115113At the moment, this is mostly an issue for Japanese sentences, which are associated with special annotations. These annotations are not displayed because they are not useful for normal users. If you change a Japanese sentence into an English sentence, then the annotations that were associated with it won't make sense anymore.
116114
117115##7. Make sure you are adding comments to the right sentence
118116
119117When you post a comment, the comment is only associated with the main sentence, so make sure that your comment is related to that particular sentence. Typically, imagine that you want to point out a spelling mistake, as in the following:
120118
121119_My name is Trang._
122120
123121_=> Je m'appel Trang._
124122
125123_=> Me llamo Trang._
126124
127125You can see that the French sentence is wrong. It should be "appelle" and not "appel". If you posted your comment here, it would be associated with the English sentence (which is the main sentence, displayed at the top). This is not what you want. The right thing to do is to click on the French sentence first. It will change the display into:
128126
129127_Je m'appel Trang._
130128
131129_=> My name is Trang._
132130
133131_=> Me llamo Trang. _
134132
135133And then you can post your comment.
136134
137135Now there is the case where you want to point out that a translation is wrong. Your comment will be related to two sentences, so where should you post it? Well, ideally, for this type of situation, there should be the possibility of commenting on a **link** between two sentences. But we don't have that, so we can only comment on a **sentence**. You are free to decide where you want to post your comment. Just remember that your comment must be related to the main sentence.
138136
139137
140138##8. Do not add sentences from copyrighted content
141139
142We are distributing the corpus under the [Creative Commons Attribution](http://creativecommons.org/licenses/by/2.0/fr/) (or CC-BY) license. It makes it possible for anyone to re-use this data in any way they want as long as they mention Tatoeba in their work.
143
144As a contributor, you have agreed with the terms of use (which of course you haven't read), and therefore you are providing your contributions under the CC-BY license as well. Which means we can re-use your data in any way we want as long as we mention you. So we are re-using your work in Tatoeba, and we mention you through the logs and the stats.
145
146But providing your work under CC-BY means you also have some responsibilities on what you provide. And you have to know that you **cannot** legally redistribute data if it was copied from a source that doesn't clearly state that you can do it. Typically, you cannot (legally) copy all the sentences from a textbook and add them into in Tatoeba.
147
148Don't worry, you (and we) won't get in jail and be in debt for life if you've added a couple of sentences from a textbook (hopefully...). But the law forbids us to take the work of someone and re-use it without their consent. Producing sentences and translations is work, so be careful where you get the sentences from. Preferably, come up with your own sentences or take them from books that are in the public domain.
149
150If you have added or have seen sentences that were copied from a copyrighted material, change a few words so that it won't be exactly the same sentence. Or, go negotiate with the authors and convince them to release their work under the CC-BY license so we can re-use it.
151
152I'm not going to argue on whether all of this makes sense or not (obviously I don't believe it does), but it will help us a lot if everyone did the necessary so we don't get sued.
140We are distributing the corpus under the [Creative Commons Attribution](http://creativecommons.org/licenses/by/2.0/fr/) (or CC-BY) license. This makes it possible for anyone to re-use this data in any way they want as long as they mention Tatoeba in their work.
141
142As a contributor, you have agreed with the terms of use, and therefore you are providing your contributions under the CC-BY license as well. This means we can reuse your data in any way we want as long as we mention you, which we do via the logs and statistics.
143
144But providing your work under CC-BY means you also have some responsibilities for what you provide. And you have to know that you **cannot** legally redistribute data if it was copied from a source that doesn't clearly state that you can. Typically, you cannot (legally) copy all the sentences from a textbook and add them into in Tatoeba.
145
146Don't worry, you (and we) won't land in jail and be in debt for life if you've added a couple of sentences from a textbook. But the law forbids us to take someone's work and reuse it without their consent. Producing sentences and translations is work, so be careful where you get the sentences from. Preferably, come up with your own sentences or take them from books that are in the public domain.
147
148If you have added or seen sentences that were copied from a copyrighted source, change a few words so that it won't be exactly the same sentence. Or go negotiate with the authors and convince them to release their work under the CC-BY license so we can re-use it.
149
150Please follow these guidelines so that we don't get sued.
153151
154152
155153##9. Do not annotate sentences
156154
157155We want sentences to remain as "raw" as possible so do not add annotations. For example we do NOT want sentences like this:
158156
159157
1601581. I (female) am happy.
1611592. It's raining cats and dogs. (idiom)
1621603. I like her/him.
163161
164162
165163Regarding sentences 1 and 2, if you need to indicate that a sentence is a proverb or female speech or whatsoever, then post a comment about it (or tag it, if you are a trusted user), but please do NOT add this information directly in the sentence.
166164
167165
168166
169167
170168Regarding sentence 3, instead of having only one sentence, split it into two sentences. Remember, you have the right to add multiple translations in a same language. So it's okay to have this:
171169
172170> Je l'aime bien.
173171>
174172> => I like her.
175173>
176174> => I like him.
177175
178176
179177
180178
181179
182180There are various reasons why we don't want annotations.
183181
184182
1851831. They can be a problem for people who are using our data in order to improve a natural language processing system, for instance.
1861842. Your translation can be retranslated into another language, and it's less easy for people to translate sentences that contain alternatives (like "him/her").
1871853. If we want to record audio for the sentence, we will need to choose what exactly to record, and annotations don't help.
188186
189187
190188
191189
192190
193191
194192
195193
196194##10. Give us feedback##
197195
198196We know that Tatoeba is not perfect so don't hesitate to [tell us](http://tatoeba.org/pages/contact) what you think is missing (just make sure no one has talked about it on the [Wall](http://tatoeba.org/wall) already). Also tell us if you see any spelling mistake, feel that some explanations are not clear, or encounter bugs.
199197
200198We also know that Tatoeba is a cool project so feel free to tell us you like it too :P
201199
202200
203201##11. Do not wait for us to code it if you can code it
204202
205203As much as we welcome feedback, we welcome even more **INITIATIVE**. There are just sooo many things we could do. We can't take care of everything.
206204
207205For instance we are distributing the _**entire **_corpus, but many people probably don't need **_all_** the sentences in _**all**_ the languages. You may just want the English-Spanish sentences. Well instead of asking and waiting for us to provide a file with only English-Spanish sentences, you can code a tool (and please, tell us if you do) that will extract only what you want from the our files.
208206
209207That's just one example but if you are a programmer, there could be many things you could do yourself instead of waiting for us to do it. But of course, tell us so we don't start working on something you plan to work on.
210208
211209You also have to know that we are actually open source (under AGPL license) but we are not really "promoting" this aspect because:
212210
2132111. The code hasn't met my standards of elegance yet... Still too many parts that make me cringe when I look at them.
2142122. We still don't have a sound methodology and organization in our way of working and I really don't have time to manage more people.
215213However if you love the project and are really motivated to join the development team, then feel free to contact us =)
216214
217215
218216
219217##12. Indicate your languages in your profile
220218
221219For people who didn't know, you can edit your profile by clicking on your username (at the top, in the menu bar).
222220
223221Since Tatoeba involves languages, it can be very useful for other users to know which languages you can speak and how well you can speak them. We don't have a specific "languages" field so you will have to write about it in your profile description (in the section "Something about you").
224222
225223And tell other users to indicate their languages as well (if they haven't already), especially if they have contributed.
226224
227225
228226
229227##13. Encourage and educate new (or even not so new) contributors
230228
231229The community is very important in a project like Tatoeba, we just can't achieve the ambition without a strong community. But how do you build a strong community? Well, one thing is NOT to make new users feel lost and isolated.
232230
233231Part of this depends on the system. It has to be designed in a way that not only enables but also encourages users to interact with each other. Tatoeba is not great at that, but you have the minimum (private messages, wall, comments).
234232
235233And the other part depends of course on the community itself. There must be an effort from the community to build a stronger community. So if someone is asking a question to which you can answer, don't hesitate to help out. If you notice someone is going something wrong, don't hesitate to tell them the right way to do it. If you notice someone or some people have been contributing significantly, don't hesitate to drop a line (in a private message or on the Wall) to say "congratulations" or "thank you" for their work.
236234
237235More generally speaking, if you have any idea on how to make Tatoeba a more socially pleasant place to be, then go ahead!
238236
239237
240238##14. Spread the love
241239
242240Last but not least: you love the project, we love the project, we all want this project to become the greatest language tool of all time, so bring more people into this adventure!
243241
244242In the end, anyone who knows how to read and how to write can participate. There's no need to be a polyglot. If you can "just" hunt for mistakes and correct them or point them out, it will be already extremely helpful. The more people, the more mistakes we can take down, the more data we can produce that people can rely on. And everyone can live happily ever after.
diff view generated by jsdifflib

Version at: 26/04/2013, 19:07

##Introduction

This article by Trang is a must-read for anyone who is serious about contributing in Tatoeba. 

Here is an outline of how to be a good contributor:

1.  [Understand the context of the project](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule1)
2.  [Understand how the corpus is structured](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule2)
3.  [Focus on the main sentence, not the other translations](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule3)
4.  [Translate the sentence as a whole rather than as a collection of individual words](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule4)
5.  [Do not edit a sentence if, by itself, it is correct](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule5)
6.  [Do not change the language in which a sentence is written](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule6)
7.  [Make sure you are adding comments to the right sentence](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule7)
8.  [Do not add sentences from copyrighted content](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule8)
9.  [Do not annotate sentences](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule9)
10.  [Give us feedback](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule10)
11.  [Do not wait for us to code it if you can code it](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule11)
12.  [Indicate your languages in your profile](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule12)
13.  [Encourage and educate new (or even not so new) contributors](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule13)
14.  [Spread the love](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule14)

[](http://www.blogger.com/post-edit.g?blogID=2196533844101218567&postID=5954885196540160002)

##1. Understand the context of the project

I will (someday) write a more detailed history, but here are the basic facts you should be aware of.

*   I started this project in 2006. The initiative was driven by my passion for language learning and frustration about not finding an adequate online dictionary.   The project is focused on **sentences** and I insist on **sentences**. Sample sentences were (and still are) a very scarce resource. Please only add **complete sentences** if you are going to contribute.
*   I was alone on this project for some time. It was only three years later, in 2009, that other people (all computer science students) started to help me out by coding more features.
*   Tatoeba is NOT a commercial project. We're not a company, we're not paid for doing any of this. It is is something that we're working on in our **free time**.
*   To be honest, we don't exclude the possibility of starting a company someday, but that is if and only if we have an innovative, coherent and ethical business model (yeah, good luck). Having ads everywhere and driving a lot of traffic, or forcing people to pay to access the data, is out of the question.

[](http://www.blogger.com/post-edit.g?blogID=2196533844101218567&postID=5954885196540160002)

##2. Understand how the corpus is structured

The corpus is structured not as a **table** but as a **graph** (in the computer science sense of the word). What does that mean? Well, imagine you had to extract part of the corpus and write it on paper. You might do something like this:

<table><tbody>
<tr>     <th style="text-align: left;">English</th>     <th style="text-align: left;">French</th>     <th style="text-align: left;">Spanish</th> </tr>
<tr>         <td>My name is Trang.</td>     <td>Je m'appelle Trang.</td>     <td>Me llamo Trang.</td> </tr>
<tr>     <td>How are you?</td>     <td>Comment vas-tu?</td>     <td>&#191;Cómo estás?</td> </tr>
<tr>     <td>...</td>     <td>...</td>     <td>...</td> </tr>
</tbody></table>

That's a **table** structure. There are **rows** and **columns**: a row contains sentences with the same meaning, and a column contains sentences with the same language. That's the first approach anyone might take, but that's NOT how the corpus is constructed.

Our corpus is set up like this: *[note: diagram needs to be imported]*

That's a **graph** structure. There are **nodes** and **edges**: each node represents a sentence, and each edge represent the link between two sentences. When two sentences are linked, they have the same meaning.

The structure of the representation has a big effect on the way you can contribute to the corpus. One important implication of the graph structure is that you can add **multiple translations in the same language** for a specific sentence. You think there are two ways to translate a sentence and you really can't decide which would be the best? Well, just add both!

Some other implications are pointed out below.


##3. Focus on the main sentence, not the other translations

When you translate a sentence, you are in fact adding a **sentence** (node) and a **link** (edge) between the original sentence and your translation. The only thing you need to care about is that you are adding a proper translation to the "main sentence" (the one at the top, in larger type).

Assume you wanted to add a Spanish translation to the English sentence "How are you?", which happens to have an existing French translation "Comment vas-tu ?" You would see the following:

_How are you?_

_=&gt; Comment vas-tu ?_

You could add _"&#191;Cómo estás?"_ (informal) or  _"&#191;Cómo está usted?"_ (formal). Even better, you could add both as separate translations of the same original sentence. You should not restrict yourself to choosing an informal translation simply because one was chosen by the person who was working in French. You should only care that your translation is a proper translation of the **English sentence**: if someone had to translate your contribution back to English, _"How are you?"_ would be a possibility.


##4. Translate the sentence as a whole rather than as a collection of individual words

We are not interested in having sentences that sound like they were written by a primitive robot that translated the individual words without regard for the sentence as a whole. We want sentences that a native speaker would really say. Translating is a very difficult task, we know. But if you are translating into your native language, you should always, always reread your translation in isolation from the original, and ask yourself if it is actually something people would say. If, for some reason, you want to add a word-by-word translation that is not what a native speaker would say, you should use the comments.

You are allowed to translate into a language other than your own, in which case you are forgiven for not writing native-like sentences. But in this case, please add a comment or tag to request that a native speaker check your sentences and correct any mistakes.

Tatoeba is not only about providing translations, it's also about gathering data about a language. Even if none of the sentences in a given language has yet been translated, those sentences are informative in themselves. However, they must be representative of their language.

To put it another way, the sentences are the basic layer in the Tatoeba corpus. The links between the sentences form another layer. But the corpus should have value even without that second layer.



##5. Do not edit a sentence if, by itself, it is correct

As I mentioned in the previous section, sentences in Tatoeba have value apart from their translations. Consequently, before you modify a sentence, look at it without paying attention to its translations, and ask yourself _"Does this sentence have any spelling or grammar mistake? Does it sound weird?"_. If the answer is "No", then do NOT edit it, **leave it alone**! If one or more of the translations is incorrect, you should break the links between them (or ask someone else to do it for you), but sentences that are valid in themselves should remain unchanged. 

You may be tempted to edit a sentence so that its meaning matches all the other sentences. Or perhaps you want to turn a sentence into a word-for-word translation. But this is not a good idea. Not only does a word-for-word translation run the risk of sounding unnatural (cf. rule #4), but you're replacing data when you could be adding new data and keeping the old.

Sometimes, a sentence may not match the original AT ALL. For instance:



_My name is Trang._

_=&gt; Je m'appelle Trang._

_=&gt; Vamos a la playa._

You notice that the Spanish sentence (which says "Let's go to the beach") has nothing to do with the English sentence.

Perhaps you don't speak Spanish very well so you're not confident in modifying the Spanish sentence and decide to change the English sentence instead. However, then you create another problem: the French sentence won't fit the English sentence anymore...

Perhaps you are a native Spanish speaker and are tempted to change the Spanish sentence. In this particular case, it would still be acceptable because the Spanish sentence is not linked to any other sentence. But if someone had translated that Spanish sentence into Italian, "correcting" the Spanish sentence would cause a conflict with the Italian translation.

Then there is a problem you may have not thought of: when changing the meaning of a sentence, you are potentially erasing unique vocabulary. What if the Spanish sentence was currently the only one with "playa" in it?

The best way to proceed in this kind of situation is to add a new Spanish translation (_Me llamo Trang_) and "unlink" the current Spanish translation. NOTE: Only "trusted users" (users with a level of advanced contributor or higher) can unlink. However, anyone can post a comment to request that a sentence be unlinked.


##6. Do not change the language in which a sentence is written

While you should correct the language flag for a sentence if it is wrong (for instance, it is flagged as Chinese when it is in fact Japanese), you shouldn't replace, say, a Japanese sentence by a Chinese sentence with the same meaning. 

The problem is that a sentence can be associated with data, such as comments, that depend on its language. People can post comments on sentences, and the comments may be valid only because the sentence was in a certain language.

At the moment, this is mostly an issue for Japanese sentences, which are associated with special annotations. These annotations are not displayed because they are not useful for normal users. If you change a Japanese sentence into an English sentence, then the annotations that were associated with it won't make sense anymore.

##7. Make sure you are adding comments to the right sentence

When you post a comment, the comment is only associated with the main sentence, so make sure that your comment is related to that particular sentence. Typically, imagine that you want to point out a spelling mistake, as in the following:

_My name is Trang._

_=&gt; Je m'appel Trang._

_=&gt; Me llamo Trang._

You can see that the French sentence is wrong. It should be "appelle" and not "appel". If you posted your comment here, it would be associated with the English sentence (which is the main sentence, displayed at the top). This is not what you want. The right thing to do is to click on the French sentence first. It will change the display into:

_Je m'appel Trang._

_=&gt; My name is Trang._

_=&gt; Me llamo Trang.   _

And then you can post your comment.

Now there is the case where you want to point out that a translation is wrong. Your comment will be related to two sentences, so where should you post it? Well, ideally, for this type of situation, there should be the possibility of commenting on a **link** between two sentences. But we don't have that, so we can only comment on a **sentence**. You are free to decide where you want to post your comment. Just remember that your comment must be related to the main sentence.


##8. Do not add sentences from copyrighted content

We are distributing the corpus under the [Creative Commons Attribution](http://creativecommons.org/licenses/by/2.0/fr/) (or CC-BY) license. It makes it possible for anyone to re-use this data in any way they want as long as they mention Tatoeba in their work.

As a contributor, you have agreed with the terms of use (which of course you haven't read), and therefore you are providing your contributions under the CC-BY license as well. Which means we can re-use your data in any way we want as long as we mention you. So we are re-using your work in Tatoeba, and we mention you through the logs and the stats.

But providing your work under CC-BY means you also have some responsibilities on what you provide. And you have to know that you **cannot** legally redistribute data if it was copied from a source that doesn't clearly state that you can do it. Typically, you cannot (legally) copy all the sentences from a textbook and add them into in Tatoeba.

Don't worry, you (and we) won't get in jail and be in debt for life if you've added a couple of sentences from a textbook (hopefully...). But the law forbids us to take the work of someone and re-use it without their consent. Producing sentences and translations is work, so be careful where you get the sentences from. Preferably, come up with your own sentences or take them from books that are in the public domain.

If you have added or have seen sentences that were copied from a copyrighted material, change a few words so that it won't be exactly the same sentence. Or, go negotiate with the authors and convince them to release their work under the CC-BY license so we can re-use it.

I'm not going to argue on whether all of this makes sense or not (obviously I don't believe it does), but it will help us a lot if everyone did the necessary so we don't get sued.


##9. Do not annotate sentences

We want sentences to remain as "raw" as possible so do not add annotations. For example we do NOT want sentences like this:


1.  I (female) am happy.
2.  It's raining cats and dogs. (idiom)
3.  I like her/him.


Regarding sentences 1 and 2, if you need to indicate that a sentence is a proverb or female speech or whatsoever, then post a comment about it (or tag it, if you are a trusted user), but please do NOT add this information directly in the sentence.




Regarding sentence 3, instead of having only one sentence, split it into two sentences. Remember, you have the right to add multiple translations in a same language. So it's okay to have this:

> Je l'aime bien.
> 
> =&gt; I like her.
> 
> =&gt; I like him.





There are various reasons why we don't want annotations.


1.  They can be a problem for people who are using our data in order to improve a natural language processing system, for instance.
2.  Your translation can be retranslated into another language, and it's less easy for people to translate sentences that contain alternatives (like "him/her").
3.  If we want to record audio for the sentence, we will need to choose what exactly to record, and annotations don't help.








##10. Give us feedback##

We know that Tatoeba is not perfect so don't hesitate to [tell us](http://tatoeba.org/pages/contact) what you think is missing (just make sure no one has talked about it on the [Wall](http://tatoeba.org/wall) already). Also tell us if you see any spelling mistake, feel that some explanations are not clear, or encounter bugs.

We also know that Tatoeba is a cool project so feel free to tell us you like it too :P


##11. Do not wait for us to code it if you can code it

As much as we welcome feedback, we welcome even more **INITIATIVE**. There are just sooo many things we could do. We can't take care of everything.

For instance we are distributing the _**entire **_corpus, but many people probably don't need **_all_** the sentences in _**all**_ the languages. You may just want the English-Spanish sentences. Well instead of asking and waiting for us to provide a file with only English-Spanish sentences, you can code a tool (and please, tell us if you do) that will extract only what you want from the our files.

That's just one example but if you are a programmer, there could be many things you could do yourself instead of waiting for us to do it. But of course, tell us so we don't start working on something you plan to work on.

You also have to know that we are actually open source (under AGPL license) but we are not really "promoting" this aspect because:

1.  The code hasn't met my standards of elegance yet... Still too many parts that make me cringe when I look at them.
2.  We still don't have a sound methodology and organization in our way of working and I really don't have time to manage more people.
However if you love the project and are really motivated to join the development team, then feel free to contact us =)



##12. Indicate your languages in your profile

For people who didn't know, you can edit your profile by clicking on your username (at the top, in the menu bar).

Since Tatoeba involves languages, it can be very useful for other users to know which languages you can speak and how well you can speak them. We don't have a specific "languages" field so you will have to write about it in your profile description (in the section "Something about you").

And tell other users to indicate their languages as well (if they haven't already), especially if they have contributed.



##13. Encourage and educate new (or even not so new) contributors

The community is very important in a project like Tatoeba, we just can't achieve the ambition without a strong community. But how do you build a strong community? Well, one thing is NOT to make new users feel lost and isolated.

Part of this depends on the system. It has to be designed in a way that not only enables but also encourages users to interact with each other. Tatoeba is not great at that, but you have the minimum (private messages, wall, comments).

And the other part depends of course on the community itself. There must be an effort from the community to build a stronger community. So if someone is asking a question to which you can answer, don't hesitate to help out. If you notice someone is going something wrong, don't hesitate to tell them the right way to do it. If you notice someone or some people have been contributing significantly, don't hesitate to drop a line (in a private message or on the Wall) to say "congratulations" or "thank you" for their work.

More generally speaking, if you have any idea on how to make Tatoeba a more socially pleasant place to be, then go ahead!


##14. Spread the love

Last but not least: you love the project, we love the project, we all want this project to become the greatest language tool of all time, so bring more people into this adventure!

In the end, anyone who knows how to read and how to write can participate. There's no need to be a polyglot. If you can "just" hunt for mistakes and correct them or point them out, it will be already extremely helpful. The more people, the more mistakes we can take down, the more data we can produce that people can rely on. And everyone can live happily ever after.

version at: 26/04/2013, 19:11

##Introduction

This article by Trang is a must-read for anyone who is serious about contributing in Tatoeba. 

Here is an outline of how to be a good contributor:

1.  [Understand the context of the project](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule1)
2.  [Understand how the corpus is structured](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule2)
3.  [Focus on the main sentence, not the other translations](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule3)
4.  [Translate the sentence as a whole rather than as a collection of individual words](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule4)
5.  [Do not edit a sentence if, by itself, it is correct](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule5)
6.  [Do not change the language in which a sentence is written](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule6)
7.  [Make sure you are adding comments to the right sentence](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule7)
8.  [Do not add sentences from copyrighted content](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule8)
9.  [Do not annotate sentences](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule9)
10.  [Give us feedback](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule10)
11.  [Do not wait for us to code it if you can code it](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule11)
12.  [Indicate your languages in your profile](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule12)
13.  [Encourage and educate new (or even not so new) contributors](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule13)
14.  [Spread the love](http://blog.tatoeba.org/2010/02/how-to-be-good-contributor-in-tatoeba.html#rule14)

[](http://www.blogger.com/post-edit.g?blogID=2196533844101218567&amp;postID=5954885196540160002)

##1. Understand the context of the project

*   I started this project in 2006. The initiative was driven by my passion for language learning and frustration about not finding an adequate online dictionary.   The project is focused on **sentences** and I insist on **sentences**. Sample sentences were (and still are) a very scarce resource. Please only add **complete sentences** if you are going to contribute.
*   I was alone on this project for some time. It was only three years later, in 2009, that other people (all computer science students) started to help me out by coding more features.
*   Tatoeba is NOT a commercial project. We're not a company, and we're not paid for doing any of this. It is is something that we're working on in our **free time**.
*   To be honest, we don't exclude the possibility of starting a company someday, but that is if and only if we have an innovative, coherent and ethical business model (yeah, good luck). Having ads everywhere and driving a lot of traffic, or forcing people to pay to access the data, is out of the question.

[](http://www.blogger.com/post-edit.g?blogID=2196533844101218567&amp;postID=5954885196540160002)

##2. Understand how the corpus is structured

The corpus is structured not as a **table** but as a **graph** (in the computer science sense of the word). What does that mean? Well, imagine you had to extract part of the corpus and write it on paper. You might do something like this:

<table><tbody>
<tr>     <th style="text-align: left;">English</th>     <th style="text-align: left;">French</th>     <th style="text-align: left;">Spanish</th> </tr>
<tr>         <td>My name is Trang.</td>     <td>Je m'appelle Trang.</td>     <td>Me llamo Trang.</td> </tr>
<tr>     <td>How are you?</td>     <td>Comment vas-tu?</td>     <td>&#191;Cómo estás?</td> </tr>
<tr>     <td>...</td>     <td>...</td>     <td>...</td> </tr>
</tbody></table>

That's a **table** structure. There are **rows** and **columns**: a row contains sentences with the same meaning, and a column contains sentences with the same language. That's the first approach anyone might take, but that's NOT how the corpus is constructed.

Our corpus is set up like this: *[note: diagram needs to be imported]*

That's a **graph** structure. There are **nodes** and **edges**: each node represents a sentence, and each edge represent the link between two sentences. When two sentences are linked, they have the same meaning.

The structure of the representation has a big effect on the way you can contribute to the corpus. One important implication of the graph structure is that you can add **multiple translations in the same language** for a specific sentence. You think there are two ways to translate a sentence and you really can't decide which would be the best? Well, just add both!

Some other implications are pointed out below.


##3. Focus on the main sentence, not the other translations

When you translate a sentence, you are in fact adding a **sentence** (node) and a **link** (edge) between the original sentence and your translation. The only thing you need to care about is that you are adding a proper translation to the "main sentence" (the one at the top, in larger type).

Assume you wanted to add a Spanish translation to the English sentence "How are you?", which happens to have an existing French translation "Comment vas-tu ?" You would see the following:

_How are you?_

_=&gt; Comment vas-tu ?_

You could add _"&#191;Cómo estás?"_ (informal) or  _"&#191;Cómo está usted?"_ (formal). Even better, you could add both as separate translations of the same original sentence. You should not restrict yourself to choosing an informal translation simply because one was chosen by the person who was working in French. You should only care that your translation is a proper translation of the **English sentence**: if someone had to translate your contribution back to English, _"How are you?"_ would be a possibility.


##4. Translate the sentence as a whole rather than as a collection of individual words

We are not interested in having sentences that sound like they were written by a primitive robot that translated the individual words without regard for the sentence as a whole. We want sentences that a native speaker would really say. Translating is a very difficult task, we know. But if you are translating into your native language, you should always, always reread your translation in isolation from the original, and ask yourself if it is actually something people would say. If, for some reason, you want to add a word-by-word translation that is not what a native speaker would say, you should use the comments.

You are allowed to translate into a language other than your own, in which case you are forgiven for not writing native-like sentences. But in this case, please add a comment or tag to request that a native speaker check your sentences and correct any mistakes.

Tatoeba is not only about providing translations, it's also about gathering data about a language. Even if none of the sentences in a given language has yet been translated, those sentences are informative in themselves. However, they must be representative of their language.

To put it another way, the sentences are the basic layer in the Tatoeba corpus. The links between the sentences form another layer. But the corpus should have value even without that second layer.



##5. Do not edit a sentence if, by itself, it is correct

As I mentioned in the previous section, sentences in Tatoeba have value apart from their translations. Consequently, before you modify a sentence, look at it without paying attention to its translations, and ask yourself _"Does this sentence have any spelling or grammar mistake? Does it sound weird?"_. If the answer is "No", then do NOT edit it, **leave it alone**! If one or more of the translations is incorrect, you should break the links between them (or ask someone else to do it for you), but sentences that are valid in themselves should remain unchanged. 

You may be tempted to edit a sentence so that its meaning matches all the other sentences. Or perhaps you want to turn a sentence into a word-for-word translation. But this is not a good idea. Not only does a word-for-word translation run the risk of sounding unnatural (cf. rule #4), but you're replacing data when you could be adding new data and keeping the old.

Sometimes, a sentence may not match the original AT ALL. For instance:



_My name is Trang._

_=&gt; Je m'appelle Trang._

_=&gt; Vamos a la playa._

You notice that the Spanish sentence (which says "Let's go to the beach") has nothing to do with the English sentence.

Perhaps you don't speak Spanish very well so you're not confident in modifying the Spanish sentence and decide to change the English sentence instead. However, then you create another problem: the French sentence won't fit the English sentence anymore...

Perhaps you are a native Spanish speaker and are tempted to change the Spanish sentence. In this particular case, it would still be acceptable because the Spanish sentence is not linked to any other sentence. But if someone had translated that Spanish sentence into Italian, "correcting" the Spanish sentence would cause a conflict with the Italian translation.

Then there is a problem you may have not thought of: when changing the meaning of a sentence, you are potentially erasing unique vocabulary. What if the Spanish sentence was currently the only one with "playa" in it?

The best way to proceed in this kind of situation is to add a new Spanish translation (_Me llamo Trang_) and "unlink" the current Spanish translation. NOTE: Only "trusted users" (users with a level of advanced contributor or higher) can unlink. However, anyone can post a comment to request that a sentence be unlinked.


##6. Do not change the language in which a sentence is written

While you should correct the language flag for a sentence if it is wrong (for instance, it is flagged as Chinese when it is in fact Japanese), you shouldn't replace, say, a Japanese sentence by a Chinese sentence with the same meaning. 

The problem is that a sentence can be associated with data, such as comments, that depend on its language. People can post comments on sentences, and the comments may be valid only because the sentence was in a certain language.

At the moment, this is mostly an issue for Japanese sentences, which are associated with special annotations. These annotations are not displayed because they are not useful for normal users. If you change a Japanese sentence into an English sentence, then the annotations that were associated with it won't make sense anymore.

##7. Make sure you are adding comments to the right sentence

When you post a comment, the comment is only associated with the main sentence, so make sure that your comment is related to that particular sentence. Typically, imagine that you want to point out a spelling mistake, as in the following:

_My name is Trang._

_=&gt; Je m'appel Trang._

_=&gt; Me llamo Trang._

You can see that the French sentence is wrong. It should be "appelle" and not "appel". If you posted your comment here, it would be associated with the English sentence (which is the main sentence, displayed at the top). This is not what you want. The right thing to do is to click on the French sentence first. It will change the display into:

_Je m'appel Trang._

_=&gt; My name is Trang._

_=&gt; Me llamo Trang.   _

And then you can post your comment.

Now there is the case where you want to point out that a translation is wrong. Your comment will be related to two sentences, so where should you post it? Well, ideally, for this type of situation, there should be the possibility of commenting on a **link** between two sentences. But we don't have that, so we can only comment on a **sentence**. You are free to decide where you want to post your comment. Just remember that your comment must be related to the main sentence.


##8. Do not add sentences from copyrighted content

We are distributing the corpus under the [Creative Commons Attribution](http://creativecommons.org/licenses/by/2.0/fr/) (or CC-BY) license. This makes it possible for anyone to re-use this data in any way they want as long as they mention Tatoeba in their work.

As a contributor, you have agreed with the terms of use, and therefore you are providing your contributions under the CC-BY license as well. This means we can reuse your data in any way we want as long as we mention you, which we do via the logs and statistics.

But providing your work under CC-BY means you also have some responsibilities for what you provide. And you have to know that you **cannot** legally redistribute data if it was copied from a source that doesn't clearly state that you can. Typically, you cannot (legally) copy all the sentences from a textbook and add them into in Tatoeba.

Don't worry, you (and we) won't land in jail and be in debt for life if you've added a couple of sentences from a textbook. But the law forbids us to take someone's work and reuse it without their consent. Producing sentences and translations is work, so be careful where you get the sentences from. Preferably, come up with your own sentences or take them from books that are in the public domain.

If you have added or seen sentences that were copied from a copyrighted source, change a few words so that it won't be exactly the same sentence. Or go negotiate with the authors and convince them to release their work under the CC-BY license so we can re-use it.

Please follow these guidelines so that we don't get sued.


##9. Do not annotate sentences

We want sentences to remain as "raw" as possible so do not add annotations. For example we do NOT want sentences like this:


1.  I (female) am happy.
2.  It's raining cats and dogs. (idiom)
3.  I like her/him.


Regarding sentences 1 and 2, if you need to indicate that a sentence is a proverb or female speech or whatsoever, then post a comment about it (or tag it, if you are a trusted user), but please do NOT add this information directly in the sentence.




Regarding sentence 3, instead of having only one sentence, split it into two sentences. Remember, you have the right to add multiple translations in a same language. So it's okay to have this:

> Je l'aime bien.
> 
> =&gt; I like her.
> 
> =&gt; I like him.





There are various reasons why we don't want annotations.


1.  They can be a problem for people who are using our data in order to improve a natural language processing system, for instance.
2.  Your translation can be retranslated into another language, and it's less easy for people to translate sentences that contain alternatives (like "him/her").
3.  If we want to record audio for the sentence, we will need to choose what exactly to record, and annotations don't help.








##10. Give us feedback##

We know that Tatoeba is not perfect so don't hesitate to [tell us](http://tatoeba.org/pages/contact) what you think is missing (just make sure no one has talked about it on the [Wall](http://tatoeba.org/wall) already). Also tell us if you see any spelling mistake, feel that some explanations are not clear, or encounter bugs.

We also know that Tatoeba is a cool project so feel free to tell us you like it too :P


##11. Do not wait for us to code it if you can code it

As much as we welcome feedback, we welcome even more **INITIATIVE**. There are just sooo many things we could do. We can't take care of everything.

For instance we are distributing the _**entire **_corpus, but many people probably don't need **_all_** the sentences in _**all**_ the languages. You may just want the English-Spanish sentences. Well instead of asking and waiting for us to provide a file with only English-Spanish sentences, you can code a tool (and please, tell us if you do) that will extract only what you want from the our files.

That's just one example but if you are a programmer, there could be many things you could do yourself instead of waiting for us to do it. But of course, tell us so we don't start working on something you plan to work on.

You also have to know that we are actually open source (under AGPL license) but we are not really "promoting" this aspect because:

1.  The code hasn't met my standards of elegance yet... Still too many parts that make me cringe when I look at them.
2.  We still don't have a sound methodology and organization in our way of working and I really don't have time to manage more people.
However if you love the project and are really motivated to join the development team, then feel free to contact us =)



##12. Indicate your languages in your profile

For people who didn't know, you can edit your profile by clicking on your username (at the top, in the menu bar).

Since Tatoeba involves languages, it can be very useful for other users to know which languages you can speak and how well you can speak them. We don't have a specific "languages" field so you will have to write about it in your profile description (in the section "Something about you").

And tell other users to indicate their languages as well (if they haven't already), especially if they have contributed.



##13. Encourage and educate new (or even not so new) contributors

The community is very important in a project like Tatoeba, we just can't achieve the ambition without a strong community. But how do you build a strong community? Well, one thing is NOT to make new users feel lost and isolated.

Part of this depends on the system. It has to be designed in a way that not only enables but also encourages users to interact with each other. Tatoeba is not great at that, but you have the minimum (private messages, wall, comments).

And the other part depends of course on the community itself. There must be an effort from the community to build a stronger community. So if someone is asking a question to which you can answer, don't hesitate to help out. If you notice someone is going something wrong, don't hesitate to tell them the right way to do it. If you notice someone or some people have been contributing significantly, don't hesitate to drop a line (in a private message or on the Wall) to say "congratulations" or "thank you" for their work.

More generally speaking, if you have any idea on how to make Tatoeba a more socially pleasant place to be, then go ahead!


##14. Spread the love

Last but not least: you love the project, we love the project, we all want this project to become the greatest language tool of all time, so bring more people into this adventure!

In the end, anyone who knows how to read and how to write can participate. There's no need to be a polyglot. If you can "just" hunt for mistakes and correct them or point them out, it will be already extremely helpful. The more people, the more mistakes we can take down, the more data we can produce that people can rely on. And everyone can live happily ever after.

Note

The lines in green are the lines that have been added in the new version. The lines in red are those that have been removed.