== Project summary ==
**User scripts** are programs written in JavaScript for use on Wikimedia projects by users. User scripts enable the Wikimedia user account to do many things that they otherwise couldn't. Like changing DOM, appending HTML snippets in DOM, and changing Interface according to browsers events etc. The project is about to create a guided adventure tour on MediaWiki and MetaWiki(?) to give users insight on “//How to create userscript on Wikimedia projects//”. The adventure will be designed like The Wikipedia Adventure”[0] which will have 3-4 missions.
* Mission 1: Basic Intro
* Mission 2: Using MediaWiki’s JS module
* Mission 3: Using MediaWiki API
* Mission 4: Using OOUI (Optional)
Of course, MediaWIki has already good documentation on user script[1] but it is not interactive. The project primarily focuses on newbie developers and existing Wikimedia community members who have little bit knowledge about JavaScript. One of the main benefits of guided tours will be If someone does outreach then every participant should go in one and the same flow (Unlike documentation where anyone starts from the section of page).
== Mentor(s) ==
#indic-mediawiki-developers will mentor this project.
1. @Jayprakash12345
2. @KCVelaga
3. @APerson
== Skill required ==
* HTML
* CSS
* JavaScript
* jQuery
== Resources ==
[0] https://en.wikipedia.org/wiki/Wikipedia:The_Wikipedia_Adventure
[1] https://www.mediawiki.org/wiki/User_script
[2] https://commons.wikimedia.org/wiki/File:Userscript_and_Gadgets_workshop_toolkit.pdf
== Micro tasks ==
==== Task 1
* [[https://www.mediawiki.org/wiki/Manual:Installation_guide|Install the MediaWiki]]
* Install [[https://www.mediawiki.org/wiki/Extension:GuidedTour|GuidedTour]] extension to MediaWiki
* Create a [[https://www.mediawiki.org/wiki/Extension:GuidedTour/Write_an_on-wiki_tour|mini tour]] with any two steps.
* Make sure your code follows [[https://www.mediawiki.org/wiki/Manual:Coding_conventions/JavaScript|Coding conventions/JavaScript]]
* Put the tour code in your wiki page under your User namespace (Like User:ABC/tour.js)
==== Task 2
* Create a basic user script that use [[https://www.mediawiki.org/wiki/OOUI/Using_OOUI_in_MediaWiki#Gadgets|OOUI in JavaScript]]. Be creative and make sure it does not use more than 6 [[https://doc.wikimedia.org/oojs-ui/master/demos/?page=widgets&theme=wikimediaui&direction=ltr&platform=desktop|widget]].
* Make sure your code follows [[https://www.mediawiki.org/wiki/Manual:Coding_conventions/JavaScript|Coding conventions/JavaScript]]
* Put the tour code in your wiki page under your User namespace (Like User:ABC/OOUI-Demo.js)
Don't put link of your work here. Share your link on Zulip.