Outreachy with Wikimedia: 30th May to 6th September, 2017

The internship is coming to an end tomorrow, 6th September 2017. I have mixed feelings. It was a great experience and to know that it is coming to an end make me happy and down at the same time. I wouldn’t be officially an intern at WMF. But the best part of open source is, you can always be a contributor and keep developing, any time of the year.

What was my project?
There is a service named citoid that generates citation data and makes it easy to insert references in the Visual editor. It uses Zotero translators and my work was to document what these translators are, how can we create them and get them deployed.

Find my work
I have created two pages, one is the extension of the other.
Main page with all the information about development
Second page explaining how to create a translator for a blog (and similar sites)

Other microtasks that I did
Before you start documenting, you need to know what is it that you will be working on. My first task was to explore what actually these translators are and what power they hold. Once I got an idea about translators, I really enjoyed developing them. I submitted a few patches to the Zotero upstream during the internship period –
The Economic times
The Open library
The Globe and Mail
BBC Newsbeat
Oxford Reference
TV by the numbers
If you wish to have a translator for any site, let me know in comments, I’ll surely try to write it.

Summary

After preparing a few translators and playing with Scaffold before internship, I started to write documentation from the first day. For the initial draft, the documentation covered the how to write a translator using Scaffold. This included development environment, concepts, working example and code details. First major improvement that was done was to use CSS selectors and remove the concept of Xpaths to define HTML nodes. Around mid-sem I got a new task, to explore how to write a translator at server-side. This was the main motive of the whole project, to find out how we can write code and test it on server, but somewhere around this time, Zotero 5.0 was released. So the documentation was updated to cover any changes that might come in the procedure of development through Scaffold.

To figure out how tests can be carried out on server, was the one task that took the most of the time. I learned about containerization and worked with Docker. A new section came into existence – Developing and testing on server, working example of Mediawiki.

For the last task, I documented how we can write translators for blog-like sites, taking the example  of Wikimedia blog because it the most common use case that people will come across and for someone who wants to skip all the details and quickly learn through an example, it will be a good landing page. This page concentrates only on development on server and not Scaffold.

Outside the internship, I will be refining the documentation further, hopefully with inputs from my mentors and the community at WMF. What’s left to do is to translate all this work in Hindi as I proposed in my application. I will also be looking into other projects at WMF that I can contribute to. It was a great experience. Outreachy Rocks!!!

Looking forward to present my work on 21st September, 2017

Note: Applications for next round of Outreachy are opening soon. Stay informed.

Screenshot from 2017-09-06 04:57:26.png

Advertisements

A letter to a guy I met that day

 

Do you need exact dates, I can give you but I guess it doesn’t matter. We got down from our bus at a place which had flyovers , and did a cab to reach your college. It was nearly 3 AM. I was midst of people with whom I felt really uncomfortable and was trying to calm myself down by saying that it’s fine, it’s part of the experiences that I want to have. We entered through the college gate and I was lost in the college, it was alive even at that time of the night. There were lights and decorations and stuff, things that you see in videos of college fests and I was finally there, coming out of my monotonous life, and out of the shell that wasn’t making me happy anymore. “He’s there”, Garv told the driver, signaling him to slow down the car and pick you up. “Who is he?” I asked Sana. “A friend of Garv”, she told me. “One more person to make you feel a misfit. What is wrong with these people of wonderland? Why do all guys look cleaner and brighter than I would ever be.” That was my first thought about you.

Little did I know, that it was a beginning of two beautiful relationships with two beautiful souls. Urvi and you. We had a great time then, and dear friend, thanks for making all the efforts to make all of your guests feel at home. I don’t really remember what our first talk was like, or when did we start talking but for sure, it was smooth. A group of people who flip like binaries. I was not there to make friends, nope. I was just trying to run from humans and be closer to other aspects of life that I had stopped to understand. The good thing was, I brought a blank state of mind, without expectations, without rules and standards to define joy and you, luckily, filled that blankness with positivity. I will praise you, for being confident about yourself, for your choice to get out of your comfort zone, that too, effortlessly as it seemed, though it might have not been in practice. I will praise you for handling a large group and make people feel together though you were the only one who could have felt the most disconnected for being from some other place, but there were no insecurities and that is commendable.

We have changed a lot, it is almost an year now. Nevertheless, this letter is for the guy I met on that day. I love giving free advice and here is some for that guy who is so eager to make new friends and live the time of his life.

Pages are fluttering desperate to be turned,

Get lost on the road, And sleep on the floor,

Be sure about change, Be ready to break the chains,

Don’t hold your smile and dance a little wild,

There are streets and avenues waiting for your footsteps,

droplets, crystals of sand, shades of green,

Places void and packed and so many things you don’t know yet,

Give chance to life to surprise you, it has waited long to unfold what it holds.

Letters shouldn’t start with a hey and end with a bye