User:Contraexemplo/Outreachy

This page is dedicated to the records of my internship period at Wikimedia. Here you will find things I've written and done throughout December, 2017 to March, 2018. My findings and conclusions will be condensed and made available on a report to be written from the end of February to the beginning of March. If there's something you think it's good for me to know or some way you can help me out, feel free to contact me.

How to become a volunteer?
The first question that needs to be asked when we talk about recruiting more volunters should be: is the process of becoming a volunteer clear? One of the things I noticed as I read all the documentation available for translators is that it doesn't state how to create an account and get a translator permission to begin contributing.


 * meta:Meta:Babylon/Translations is an excellent page to introduce new people to the process of translation on Wikimedia. But even though it's arguably less confusing than the Extension:Translate page, it doesn't include that valuable information (and this is going to be addressed and corrected soon). However, this situation is just a symptomatic indication of a bigger problem: the uncertainty of the profile of those who read the documentation. From what I saw and read, wikimedians will deal with the current state of documentation with ease while non-wikimedians will get lost.

In a way, being a person not so familiar with the way Wikimedia functions works in my favor: while Johan and Benoît have years of experience under their belt, I have the perspective of someone who is confused with the complexity of the projects. This makes me easily perceive what is missing to understand clearly the path I need to make to become a contributor and to make outstanding contributions.

By the way, about the documentation...
MediaWiki.org already has a Documentation Style Guide describing best practices when writing and formatting documentation. However, I think its presentation could be done better and more information can be added. Take, for instance, Atlassian's Style Guide. It's brief, but presents information in such a way the reader doesn't need to think much: it has tables comparing bad and good practices and explanations about why they chose do adopt certain patterns. This is an excellent way to set a quality standart to everything that needs to be written: it's a clear, quick and effective read.

Today I was also reading (and honestly admiring) the documentation written by and aimed for the localization team of Mozilla. This one, for example, is aimed for Brazilian Portuguese translators. Take a look into how welcoming and organized the page is. It presents all meaningful information that is needed to become a translator and introduces the community involved directly with this task at the same time. Well, what in this documentation makes it so well written?
 * 1) Its landing page is brief. The objective of it is to gather all information that may be useful to those who want to begin contributing: where to contact the team responsible for this kind of work, how to join it, what are they doing, how to start contributing and what resources are relevant.
 * 2) Their glossary has an interesting structure. In Portuguese, words have gender. Not only they provide the appropriate translation to a word but they also give the reader an example of the context it is used and its gender. This normalizes the translation, making it more cohesive. I'd go further and provide a list of synonyms that can be used on longer texts (for instance, espaços de nomes and espaços nominais refer to the same thing [namespaces] without losing the real meaning in the translation). (There is a task on Phabricator to make something similar to the Transvision Glossary used by Mozilla, by the way!)
 * 3) They have facilitators to help newcomers to settle down. This is important for two reasons: one, it helps people to perceive that nothing happens by magic. Things are build by the effort of thousands of volunteers and citing them makes this crystal clear. Two, it creates a bond with the existing community and motivates newcomers to stay because of this bond. I may love the tools, the projects, the software, but I stay because I feel welcomed and belonging. This is exactly what community identification is about.

How to attract new people?
If that answer was obvious I probably wouldn't be here.

I was talking about some of the results of a preliminar survey I made before being selected to the internship on the meeting today when Benoît pointed out the New Editor Experiences page. Their findings resonate with a lot of my hypotheses and this is really reassuring. The problem, though, is that it's more easy to point out what is wrong than to find out how to solve it. And finding some of the answers is exactly what my work is about.

Questions to think about tomorrow

 * How can I help improve the documentation? I need to gather resources concerning content and presentation. For that, I'll contact people who are used to work with it and keep reading other FOSS projects' documentation.
 * How can I build bridges between people who are already wikimedians and newcomers? It was quite difficult to find my local community so I think this is something I need to put some effort on. There are also some ways to talk with only wikimedians who deal with translation but are they universally accessible and easy to find?

"How to start" page
After some searching I finally found a page talking about how get started to become a translator at the adequate wiki: translatewiki:Translating:How to start. However, it still feels... incomplete? There's a lot of "do this", "do that" but good resources to empower translations are missing and it still presumes you are familiar with the whole process of contributing. And once again, I feel like valuable information is all over the place. But as I said yesterday, meta:Meta:Babylon/Translations is a good immediate solution to this. I need to find ways to improve it and make it even more suitable to newcomers.

Path to become a translator

 * 1) You go to translatewiki.net and make an account stating the languages you know, choosing an username, password and e-mail to register.
 * 2) You need to make some translations to complete your registration. You click in "Translate" and is redirected to page designated to teach you how to use the tools. I made an account for testing and I had to reach the limit of 20 translations until the page stated it was enough. Now I need to wait to have my translations verified and be granted a translator permission. (It was 10:28 AM here in Brazil when I completed the training, let's see how much time is needed for that).
 * 3) Follow-up: it took less than 40 minutes (according to the e-mail I received, the translator permission was granted at 10:59 AM). The account is now ready to go.

Core problems
I'm getting to the conclusion that whatever I read will have the same core problems: So I think I'm finally beginning to find out what needs to be my focus throughout the internship. I'm aware those three things are related to the way Wikimedia was built and by now they are part of its culture, but there has to be a way to mitigate its consequences with immediate solutions and long-term care.
 * 1) Information is too fragmented.
 * 2) There is a lot of assumptions and the most troubling one is presuming you are familiar with the way Wikimedia works.
 * 3) Good resources to establish a quality standard are missing.

Pages and resources for translators

 * MediaWiki:
 * 1) Help:Extension:Translate/Translation example.
 * 2) Help:Extension:Translate/Translation best practices.
 * 3) Help:Extension:Translate/Statistics and reporting.
 * 4) Help:Extension:Translate/Quality assurance.
 * 5) Help:Extension:Translate/Message group states.
 * 6) Help:Extension:Translate/Off-line translation.
 * 7) Help:Extension:Translate/Glossary.


 * TranslateWiki:
 * 1) translatewiki:Translating:How to start
 * 2) translatewiki:Translating:Intro
 * 3) Localisation guidelines
 * 4) FAQ


 * Meta-wiki:
 * 1) meta:Meta:Babylon/Translations/New translators
 * 2) meta:Meta:Babylon/Translations
 * 3) Technical Collaboration/Community collaboration in product development/Tech ambassadors and translators (+ Tech/Translators/List)


 * Newsletters:
 * 1) Newsletter:Translators


 * Mailing lists:
 * 1) Translators-l

List of tasks to complete until the end of the week

 * Read all the pages and resources listed in the previous note.
 * Make anotations about the current state: what assumptions does it make? Is the aimed public clear? Was it translated? If so, to how many languages?
 * Keep searching for localization related resources in other FOSS projects. What points do they have in common? What patterns do they follow?

Brief follow-up about the path to become a translator
I updated with more reliable information about how much time it took to receive a translator permission on my account for tests.

I didn't remember you receive an e-mail telling you that your translations were verified and you were granted translator rights so it was good to redo the whole process. More importantly, I didn't remember exactly what is said in this message and reading it again gave me some new questions to think about.


 * 1) Would it be useful to remind new translators of all the documentation available for them in this e-mail?
 * 2) What about connecting them with other translators of the same language? (Related: SupportedLanguages on MediaWiki.org)

Active tech translators
I got curious about the role and now I've got more reading to do. Related pages and discussions:
 * Coverage of technical translators for the top 25 Wikimedia projects
 * Top 25 wiki projects in terms of active contributors have at least one active tech ambassadors and one translator identified
 * meta:Talk:Technical Collaboration/Community collaboration in product development/Tech ambassadors and translators

Searching for more things, I've found this: ...which led me to this:
 * Translation coordinators per language
 * Translation teams

This is really interesting and talking to some of the people involved may be useful to get a broader perspective since right now I have only the perspective of a translator (myself). So here is more things to think about: what are the right questions to do? What should I be aware of? Most importantly: how can my work help them and how can their work help me?

Manuals of style for each language
Benoît proposed a demo so I'd know details about the translation process. He mentioned this task and since I like to explore a bit, I ended up reading past discussions and taking a look into this other task. One comment caught my attention: the one mentioning Language guides. I shared that with them and received an answer mentioning Wikimedia:Manual of Style. I mentioned on I was looking for ways to define a standard for documentation and this is exactly one of the things that I wanted!

I also need to correct myself. In, I wrote "Good resources to establish a quality standard are missing" but that's incorrect because it gives you the impression they don't exist. What I'm beginning to figure out is there are good resources out there, but people aren't aware of them since important documentation doesn't mention them explictly.