User:Bagariavivek/GSoC Application

Identity
Name: Vivek Kumar Bagaria Email: vivekee047@gmail.com Project title: WatchList => Revamping the WatchList structure to incorporate groups.

Contact/working info
Timezone: Bangalore, India .UTC + 5:30 hours Typical working hours: 9 am to 3am IRC or IM networks/handle(s): potter on Freenode Phone: +91 9176079646

Project summary
The main goal of the project is to revolutionize the way watchlists are used.

What we already have
Currently, we only have a single watchlist in which the user keeps pages which are important. For example, pages which the user edits/creates, pages to be read or pages which the user follows regularly. The current watchlist format is efficient only if the number of pages is limited.

Problem
As the size of the Watchlist increases, its effectiveness decreases. It becomes tougher for the user to keep track of the different kinds of pages. A large sized watchlist forces the user to delete pages in order to keep it to a manageable size. Another problem is that it is not possible to get back pages which have been deleted from the watchlist.

Solution
I propose to have multiple watchlists each of which will be called a WatchGroup as a whole. This will help users group their pages in their desired manner. For example, having separate WatchGroups for pages which he creates, edits, follows etc. This will also help the user to maintain groups in the order of preference, thus allowing him to retain all the pages he needs.

The WatchGroup structure will increase a user's efficiency. As a result, we can expect an increase in the quality of articles and better editing and reviewing of articles due to improved visibility. A provision for getting back deleted articles will also help the user to retain articles in case of accidental deletion.

Required deliverables

 * Increase user efficiency by enabling quick access to the required pages.
 * Provide the facility to shift pages from the user's current watchlist to the WatchGroup.
 * Have required APIs to access the data in the WatchGroup.
 * Incorporate hooks at the required sections of code.
 * Have efficient SQL Queries.
 * Have a page containing the creation details of the user's WatchGroups.
 * Document the code well (I do this for all codes, regardless of size. I learnt it the hard way).
 * Error handling and informative error reporting.

If time permits

 * Ajaxify and incorporate JS for better visualization.
 * Add extensions equivalent to CollaborativeWatchList, WatchSubpages.
 * Suggest to the user WatchGroups to which a new page can be added.

Project schedule
I have official holidays from 1st may to 10th Aug. Thus after two days of enjoyment work begins. During holidays I will be working 38-42 hrs/week.

(3stMay-23rd May) -- "The Ramp up time".
 * Fixing design of WatchGroup and relevant code required. Interview various users, in order to understand their needs completely. Designs of the hooks will also be finalized.

I have divided my work into two milestones.

Milestone 1(23rd May -- 9th July)
Develop SpecialPages mentioned below. After this pages can be added to WatchGroups by using the SpecialPage. Develop actions like watch  and unwatch  for WatchGroups. Now,pages can also be added/removed using '?action=(un)watch&group=groupname' and
 * 23rd May -- 1st June
 * 2nd June -- 8th June

using '?action = watch' will redirect them to a page with a list of groups Develop the various APIs mentioned below. Now, pages can also be added/removed/timestamped via APIs. Testing and reviewing the code with other developers. Changes will be implemented alongside. Implement the changes suggested by other developers. Final documentation of the code. Merging with trunk( I don't know how to do this as of now). Test the code again and make bug-fixes.
 * 9th June -- 21st June
 * 22nd June -- 25th June
 * 23rd June -- 30th June
 * 30th June -- 1st May(Parallel documentation will be taking place along with the above)
 * 1st July -- 5th July
 * 6th July -- 9th July

Milestone 2(10th July - 9 Aug )
Work related to shifting pages from one group to another. Testing and reviewing the code. Documentation of the whole code. Merging with trunk.
 * 10th July -- 26th July
 * 1) SpecialPage for shifting pages between WatchGroups.
 * 2) Create actions for shifting.
 * 3) APIs for shifting articles.
 * 27th July -- 31st July
 * 1st August -- 2nd August
 * 3rd August -- 6th August

The time from the 6th to 20th August is buffer time which will be used to complete unfinished work(due to unforeseen delays).

Note:My college starts on the 10th of Aug, so I will be working 20-22hrs per week from the 10th.

About you
I am a 19 year old from Bangalore, India. I am currently pursuing my 2nd year undergraduate studies in Electrical Engineering in IIT Madras, Chennai. I have been involved in web development for the past 2 years. I code in C, C++, Java, PHP, Python(django), JS etc. I commit myself to projects that excite me and which I believe will have a positive impact.I am a very fun loving person who mingles quickly with people.

I have always seen MediaWiki from the users' point of view and this is why this project means a lot to me because it will have a major and immediate impact on the user. I want to stress again that this project will take MW a step higher upon its implementation. I would love to continue my work with MW even after this. Therefore, this project means a lot to me as I consider this as my first major step towards becoming a WMF developer.

Participation
One of the reasons I like MW is that people on #mediawiki and #wikimedia-dev are active and respond in no time. I will spend a considerable amount of time(i.e. 24 hours -sleeping -eating) on these channels. I will be active even after GSoC.
 * IRC

I have subscribed to various MW related mailing lists and I will be using these often and hopefully,effectively, to ask doubts and take suggestions. For example, WikiTech for general technical doubts, mediawiki-api for API related doubts ,mediawiki-codereview for code review related stuff.
 * Mailing List

I will sending weekly(or perhaps even more frequently) reports to respective mailing lists.

I will maintain a blog on which I will post all the things which happen during GSoC.
 * Blog

I have a few projects in git and now that we have migrated to git, it will be easy for me to integrate the code.
 * Git

Past open source experience
MediaWiki is my first encounter with open source and I have been a part of this community for the past three months. My contributions to mediawiki include a number of patches - 1, 2, 3, 4, 5, 6, 7 and a bug report with a patch 8. There are lots of patches on which I am working and will submit soon. I have participated in various hackathons including the hackathon by MW in Chennai.

I am one of the prominent web-developers in my college and I have worked on many sites like ( | IITM techfest, | My hostel site, IITM cultural-fest site ).

Any other info
Basic Structure of the Code

I have defined basic template for some of the classes and will be adding more. Suggestions are most welcomed :)

This is not an exhaustive list of classes.

Special Pages

 * 1) Special:WatchGroup.
 * 2) Special:EditWatchGroup.
 * 3) Special:WatchGroup/.
 * 4) Special:EditWatchGroup/.
 * 5) Special:DeletedWatchList.
 * 6) Special:ShiftPageWatchGroup.

API

 * 1) list of all the WatchGroups.
 * 2) list of pages from a WatchGroup.
 * 3) WatchListRSSFeed for a WatchGroup.
 * 4) Shift pages from between WatchGroups.
 * 5) Recent changes in a WatchGroup.
 * 6) List of deleted pages from WatchGroup.
 * 7) Details of WatchGroup creation.

Others

 * 1) Define action for watch/unwatch.
 * 2) To be added.