Information for your profile
Name: Dibya Singh
Email: divyalife526@gmail.com
IRC or IM networks/handle(s): Phoenix303
Location: India
Synopsis
Special:SearchTranslations is a tool that makes translation of system messages to different languages easy. This tool currently allows a translator to search for strings in the source language and displays those messages that contain that exact string (i.e. in source language). The current work-flow of a translator:
- Search for a string, "wiki" (source language being English)
- Select a language filter from the left panel (the target language for the translator)
- Get results in source language (messages which contain "wiki")
- Click Edit translation to change the translation.
Though the current settings are very flexible, they are probably more confusing to the translator. This project aims to make the process of searching and translating better, by forming productive work-flows for the translator.
Some critical areas of improvements which I have gathered from translators are:
- If a translation exists for a search string, then the translator sees results in the target language (can review and edit the stored translation).
- Ability to add translation for untranslated messages.
- User should be able to perform specialized searches.
Additionally UI enhancements will improve the usability of the tool. Through these points this project aims to streamline the work-flows of translators improving productivity and consistency, hence saving translators' time.
I have identified a few customers of Search Translations who I will be in constant contact with during the project to (re)determine my goals and progress:
Customer | Link to Search Translation |
MediaWiki | link |
Meta-Wiki | link |
Translatewiki.net | link |
Translate Blender | link |
Intense | link |
The approach I took to identify and contact the customers is:
- Open Wiki page of each user mentioned here.
- Go to Special:SearchTranslations.
- If translation search service found, contact them whether they are using it actively.
Possible Mentors
Niklas Laxström, Federico Leva, Nik Everett
Deliverables
Please describe the details and the timeline of the work you plan to accomplish on the project you are most interested in (discuss these first with the mentor of the project).
Project: Reinvent Translation Search
Testing plan: I have already set up my local environment where I will develop and test the deliverables. To interact with the customers I will create another environment where they can test the current development and give feedback.
This project consists of the following tasks:
Task 1: Categorizing Translation Search Results
We are dividing the message list into categories: translated, untranslated and outdated tabs. The translated tab will display messages in target language (expected to come from the Universal Language Selector by default). The untranslated tab will display messages which are not translated yet. Any message can be edited by the translator. These tabs can also accessed from a side panel containing links to the tabs. Target language are changed through a side panel. Results can be filtered into specific message groups through an option. Translator can also choose between case-sensitive and case insensitive searches through a checkbox. Translator can also choose to do a "match any word" or a "match all words" for the search query.
We can find translated messages in the target language by finding message key pairs. From this translated list we can extract all translations marked as fuzzy for the outdated message list. The untranslated messages in the target language can be displayed if the message key of the string in source does not exist in the target language and on translating these messages it would be added as documents in the index.
A checkbox beneath search box will force the search to look for case sensitive matches with search analyzer.
User story:
- As a Spanish translator I search for home in English, and can choose to display either messages with casa or messages in Spanish messages which have home and need translating.
- I can change my target language to French.
- I can also display message from a specific message group.
- I can also do a special search like only searching for messages with a specific key, or which contain special characters, or even matching all/any words in message query.
- I can also do a case sensitive search.
Related tasks that will be done
Example Diagram
Task 2: Specialized Searches
This task gives the translator more search options to get results from the tool in one go, reducing the number of clicks required. The following options are included:
Searching with parameters:
- type (default is msgall): This gives the type of search.
- "key" for message-key searches
- "exact" for exact matches
- "msgany" to match any word in the query string
- "msgall" to match all words in the query string
- status (default is all): This gives the status of result messages.
- "all" for all messages
- "translated" to match translated messages
- "untranslated" to match untranslated messages
- "outdated" to match outdated messages
- lang (default from ULS): This gives the target language of the search as 2 letter code. e.g. de for German, fr for French and so on.
- grp (default is all): This gives the message group that's selected for the search. e.g. MediaWiki, MediaWiki (core) etc.
- case (default is false): This gives whether the search is case sensitive or not.
The query string is parsed to retrieve all options values and message value to be searched. The option values are then extracted from the query string. Then filter the results based on options. If no value is found for any option then its default value will be used. Also, autosuggest feature shows the possible values of search parameters.
Also allowing wildcard searches to return results that match combinations of characters and wildcards example edit* will match any word starting with edit.
User story:
- As a translator I may know the exact kind of special search I want to perform and get results match my query by writing a single query string containing all my search options.
- While typing a specialized search, I am shown auto suggested values of search parameters.
- I can do wildcard searches and have matching results displayed.
Related tasks that will be done
- T93527: More search options for Special:SearchTranslations: type,status, lang, grp, case
- T70518: Special:SearchTranslations: allow messageid with ElasticSearch
- T62570: Allow "go" search feature to reach messages
Example Diagrams
Task 3: UI Enhancements
Display message snippets for large messages and show the full message when translator clicks on it. Allow filtering results by subgroups.
User story
- As a translator I will be able to display messages only from a particular message subgroup.
- On selecting a filter I won't see duplicate links.
- When search results are empty I do not see any filters.
- I will see limited text for large messages.
Related tasks that will be done
- T54703: Meaningless group selector on Special:SearchTranslations
- T49919: Language and group facets are duplicated when selected
- T50291: Do not display facet headers when there are no facets
Detailed Timeline
Include a brief, clear work breakdown structure with milestones and deadlines. Make sure to label deliverables as optional or required. It’s OK to include thinking time (“investigation”) in your work schedule. Deliverables should include investigation, coding, deploying, testing and documentation.
After each task completion log user's feedback, assess them and make the required changes. Documentation will be carried out in parallel.
Deadlines | Milestones |
Before the project begins | Testing environment has already been setup. |
May 4 - May 8 | Set up a test wiki. Document the same. T98301: Setup test wiki for translation search |
May 11 - May 29 | Work on Task 3: UI Enhancements T97943 T54703 T49919 T50291 T100393 |
Write a report on Task 3 | |
Create the design mock-up and storyboard | |
June 1 - June 5 | Add new parameters for indexing languages that a message key is translated and untranslated to, T101220 |
June 8 - June 10 | Make code changes to update() messages T101222 |
June 11 - June 17 | Develop functionality to display outdated translations T101221 |
June 18 - June 19 | Perform Usability testing. |
Notify users to test implemented features. | |
Gather potential bugs based on the feedback. | |
June 22 - June 24 | Fixing bugs |
June 25 - June 26 | Design and implement status searches(translated, untranslated and outdated messages) T100175 |
June 29 - July 3 ( Mid Term Evaluation ) | minimum product deployed: Display translated, untranslated and outdated messages for a search |
Add support to perform message-key search T70518 | |
Add support to perform case sensitive search. T97944 | |
July 6 - July 10 | Add feature for exact match searches, searching any word in the string, searching all words in the string. T100346 |
July 13 - July 17 | Support for wild-card search. T100345 |
July 20 - July 22 | Perform testing for specialized search as they are interdependent tasks. |
July 23 - July 31 | Code the autosuggest feature to access operators. T98559 |
August 3 - August 7 | Test all the features and gather user feedback and potential bugs. |
Develop T100417 | |
August 10 - August 15 | User interface improvement. |
August 16 - August 17 | Bug fix and improve the documentation. |
August 18 | Pencils down. |
Participation
We don't just want to know what you plan to accomplish; we want to know how. Briefly describe your work style: how you plan to communicate progress, where you plan to publish your source code while you're working, how and where you plan to ask for help. (We will tend to favor applicants that demonstrate a clear vision for what it means to be an active participant in our development community.)
My work style till now has consisted of the following steps:
- I clearly understand the requirement (if there are any questions, for clarity I ask in MediaWiki-General and #wikimedia-dev IRC channels)
- Then I dig into the code to investigate what exactly was causing the problems
- I test my solution and then submit my patch in Gerrit
- Based on feedback on submitted patch, I make appropriate changes and resubmit.
Since this approach has worked well for me, I plan to use the same for my Outreachy project as well.
For communicating my progress with my mentors, I plan to use the IRC and/or mailing list to directly update my weekly progress. Apart from this, I will also blog about the work I have completed each week.
I plan to publish my work on Gerrit while the project is under progress. This will allow mentors to view it and give feedback.
As I have been using IRC significantly for my previous MediaWiki patches, I will continue to use this resource for when I need help. Also, I will be using the mailing list when required.
About you
Education completed or in progress: I have a Bachelor of Technology degree from SRM University, India.
How did you hear about this program? I have heard about this program from Wikimedia blogs.
Will you have any other time commitments, such as school work, another job, planned vacation, etc., during the duration of the program?
No, other than 4 hours in a week for volunteering work at an elementary school, I have no other time commitment.
We advise all candidates eligible to Google Summer of Code and FOSS Outreach Program for Women to apply for both programs. Are you planning to apply to both programs and, if so, with what organization(s)?
No, as I am not eligible for it.
We don't just care about your project -- you are a person, and that matters to us! What drives you? What makes you want to make this the most awesomest wiki enhancement ever?
Outreachy can give me a unique opportunity to make an impact at a level I have never made before. I am very excited about this project and want to develop an excellent product that makes the lives of people easier. This change that I could bring to the world will be a big achievement in my life and that is what drives me.
You don't need to write out your life story (we can read your blog if we want that), but we want to know a little about what makes you tick. Are you a Wikipedia addict wanting to make your own experience better? Did a wiki with usability problems run over your dog, and you're seeking revenge? :-) What does making this project happen mean to you?
I am a long time user of Wikipedia. In my school days I frequently referred to content in Wikipedia for material for my science projects and exhibition posters. Nowadays I use it as a reliable source for information whenever I need to look up something be it movies, people, companies, countries, and so on.
As a contributor in MediaWiki over the last 2 months, I have learned about the developer efforts that go to build this seamless and user friendly product. This fascinates me and therefore I want to be a part of this community.
Past experience
Please describe your experience with any other FOSS projects as a user and as a contributor:
I have used Firefox for many years now and use it almost everyday for web browsing. I work with Firebug for web development. Also, I have been using Ubuntu for more than a year now. Ubuntu Software Center is a feature I like as it has made installation easier than before.
Please describe any relevant projects that you have worked on previously and what knowledge you gained from working on them (include links):
The relevant projects (microtasks) that I have worked on are:
- Load the other groups with search results in the group selector (link): I learned how to load groups in the group selector and how recent and default groups are loaded, hence learning about the working of the group selector.
- Reindex tool to update index mapping (link): I learned how to update index mapping.
- Correctly position the triangle shaped callout of group selector (link): I learned about javascript and CSS coding conventions used in MediaWiki and also positioning to support RTL languages.
- Fixed language and group facets duplication (link): I learned about grouppath option.
- Search message with message key (link): I learned about index mapping and how the index and the search analyzers work.
- Separate message for Summary field with 4 tildes (link): I learned about coding conventions for internationalization (i18n).
What project(s) are you interested in (these can be in the same or different organizations)?
The project I am most interested in is One stop translation.
Do you have any past experience working in open source projects (MediaWiki or otherwise)? If so, tell us about it! If you have already written a feature or bugfix in a Wikimedia technology such as MediaWiki, link to it here; we will give strong preference to candidates who have done so.
Yes, I have submitted various patches for different extensions of MediaWiki which have been merged. They can be viewed here.