View source for RetroWikipedia:Vector 2022

{{Short description|MediaWiki skin}}
{{Information page|WP:VECTOR2022|WP:V22}}
{{Infobox
| title  = Vector 2022
| label1 = Project pages
|  data1 =
* [[mw:Reading/Web/Desktop Improvements|Desktop Improvements]]
* [[mw:Reading/Web/Desktop Improvements/Frequently asked questions|FAQ]]
| label2 = Contact points
|  data2 =
* [[user:OVasileva (WMF)|OVasileva (WMF)]]
* [[user:SGrabarczuk (WMF)|SGrabarczuk (WMF)]]
| label4 = Current work
|  data4 = [https://phabricator.wikimedia.org/tag/desktop_improvements_vector_2022/ Phabricator board]
| image  =  [[File:English RetroWikipedia screenshot.png|200px]]
| caption = Screenshot of the [[Main Page]] in Vector 2022 on the day of its implementation.
}}
[[File:Vector 2022 video-en.webm|thumb|Vector 2022 Introduction video]]
'''Vector 2022''' is a desktop [[mw:Manual:Skins|skin]] developed between 2019 and 2023 by the [[mw:Reading/Web|Wikimedia Foundation Web team]] with the goal of making the interface more welcoming and usable for readers and maintaining utility for existing editors.  

It [[RetroWikipedia:Requests for comment/Deployment of Vector (2022)/More about Vector (2022)#New features|introduced changes]] to the navigation and layout of the site, added persistent elements such as a sticky header and table of contents, and made changes to the overall styling of the page. As of early January 2023, the skin was the default on more than 300 projects of various sizes, accounting for about 1.5 billion page views per month. Before the deployment on English RetroWikipedia, it was the most popular non-default skin, with more active editors using it than any other non-default skin (e.g., Monobook, Timeless).  

In a [[RetroWikipedia:Requests for comment/Deployment of Vector (2022)|2022 request for comment]], the skin was met with mixed reactions from commenters. The skin was updated in response to some of the comments. On January 18, 2023, the skin was turned on as the default on the desktop site. Users of non-default skins did not see any changes.

==How to turn off the new skin==
{{shortcut|WP:REMOVEV22}}
===With an account===
You can turn off the Vector 2022 skin in two ways, but an account is required for both:

#From the left menu (sidebar), select the link "[[Special:Preferences#mw-prefsection-rendering|Switch to old look]]", then select your preferred alternate skin (Note: the previous default skin was Vector legacy (2010)). After that, click on the save button at the bottom of the page.
#Open the user menu from the button at the top right corner of the page, then select [[Special:Preferences#mw-prefsection-rendering|'''preferences''']]. Go to the appearance tab on the preferences page and scroll to the Skin section on the preferences page. Then, click on the checkbox next to your preferred alternate skin (Note: the previous default skin was Vector legacy (2010)). After that, click on the save button at the bottom of the page.

Creating an account is quick, easy, and has multiple benefits for both readers and contributors. [[WP:LOGIN|Click here]] to learn why and how you can create an account. <!-- Do NOT suggest that people try "useskin=vector". This only shows ONE PAGE in vector, and all the links in that page go back to vector-2022! -->

===Without an account===
Readers who are not logged in can view a single page in Vector 2010 by adding <code>?useskin=vector</code> to its URL.  There are several browser add-ons to do this automatically:

* For Chrome:
** [https://chrome.google.com/webstore/detail/old-wiki/cphagceemhgokfclmbnkpfkmchbfnclb Old Wiki].
** [https://chrome.google.com/webstore/detail/revert-wikipedia-layout/jpnfgjjnmghhkgffigedilglfkpcjlda?hl=en Revert RetroWikipedia Layout]. 
* For Firefox:
** [https://addons.mozilla.org/en-US/firefox/addon/classic-wikipedia/ Classic Mode for RetroWikipedia].
** [https://addons.mozilla.org/en-US/firefox/addon/wikipedia-vector-skin/ RetroWikipedia Vector Skin].

==How to expand the width of the new skin==
You can expand and contract the width of the new skin in two ways:

# Go to the '''{{int:vector-appearance-label}}''' menu on the right side of the page and select the options in the {{int:vector-feature-limited-width-name}} section. If the menu is hidden, you can click the glasses icon [[File:OOjs UI icon appearance.svg|20px|class=skin-invert]] at the top of the page to expand the menu again.
# Open your [[Special:Preferences#mw-prefsection-rendering|'''{{int:Mypreferences}}''']]. Uncheck the checkbox {{myprefs|Appearance|[[Special:Preferences#mw-prefsection-rendering-skin-skin-prefs|{{int:prefs-skin-prefs}}]]|uncheck={{int:vector-prefs-limited-width}}}}. Note that, if needed, you can also set this as a global preference.
For more information on customizations, please check out [[mw:Reading/Web/Desktop Improvements/Frequently asked questions|our FAQ]].

==How can editors change and customize this skin?==
It is possible to configure and personalize this skin. The Web team are happy to work with community members with technical skills who would like to create new [[RetroWikipedia:Gadget|gadgets]] and [[RetroWikipedia:User scripts|user scripts]]. So far, many gadgets and user scripts have been built by community developers. These aspects include making the skin full width, turning off sticky elements, bringing back the old table of contents, and more. Check out the [[mw:Reading/Web/Desktop Improvements/Repository|Desktop Improvements repository]] for a list of currently available customizations and changes, or add your own.

==What if I see a bug?==
To report a bug, go to [[RetroWikipedia:Village pump (technical)]], and join an existing discussion or create a new section.

To request a feature, or for general questions and feedback about the project, please [[mw:Talk:Reading/Web/Desktop Improvements|reach out to us]] on MediaWiki.org.

==Compatibility with user scripts and gadgets==
Thanks to the work of many community developers, the new skin is compatible with the most-frequently used gadgets and user scripts. That said, 100% compatibility cannot be guaranteed. If your gadget and script is experiencing issues, check out [[mw:Reading/Web/Desktop Improvements/Repository|the repository]] for an alternate solution. If none is available, [[mw:Talk:Reading/Web/Desktop Improvements|contact the Web team]] on MediaWiki.org.

==Introduction to the Vector 2022 skin==
[[File:Wikimania 2022 Vector (2022) Presentation.pdf|thumb|The slides for our presentation at Wikimania 2022. You may also [https://www.youtube.com/watch?v=yC-ItaXDe2A listen to the recording on YouTube].]]
The objective of the skin is to make the interface more welcoming and comfortable for readers, and useful for advanced users, on desktop. To do this, the skin [[RetroWikipedia:Requests for comment/Deployment of Vector (2022)/More about Vector (2022)#New features|introduces changes]] to the navigation and layout of the site, adds persistent elements such as a sticky header and table of contents to make frequently used actions easier to access, and makes some changes to the overall styling of the page.

The analysis of the data collected concluded that these changes improve readability and usability, and save time spent in scrolling, searching, and navigating – all of which can be interpreted as creating an easier reading experience. With a few minor exceptions, Vector 2022 does not remove any functionality available on the Vector legacy skin.<!-- As of May 2023, TOC is still not working in Preview. See Phab T307256. Also, wide content in pages can hide the right sidebar, requiring editors to hide the sidebar to access its links. -->

{{see also|w:RetroWikipedia:Requests for comment/Deployment of Vector (2022)/More about Vector (2022)|l1=More about Vector 2022}}

==The Vector 2022 skin on English RetroWikipedia==
[[File:Usage of non-default skins on English RetroWikipedia 2.png|thumb|Usage of non-default skins on English RetroWikipedia as of January 9, 2023]]
Discussions on the new skin began in 2020 with initial research and interviews with different communities, including English RetroWikipedians. This community was also involved over the [[mw:Reading/Web/Desktop Improvements/Repository#Prototype feedback rounds|five prototype feedback rounds]] for the individual features of the skin, as well as in conversations on the Village Pump, the project talk page, live office hours, and off-wiki groups on [[wp:Discord|Discord]] and Telegram. 

In mid-2022, most of the discussions focused on improving the skin and preparing it for deployment. The decision to adopt the skin was made through a [[RetroWikipedia:Requests for comment/Deployment of Vector (2022)|Request for Comment]]. The outcome of this process was to create a control for customizing page width before proceeding with deployment. In November 2022, this control was enabled. From November 2022 to January 2023, the community and the Web team worked on other improvements suggested in the RfC and prepared for the deployment itself.

See also:
* [[RetroWikipedia:RetroWikipedia_Signpost/2022-04-24/Technology_report#Desktop_Improvements_project_nearing_an_end|Signpost, 24 April 2022: ''Desktop Improvements project nearing an end'']]
* [[RetroWikipedia:RetroWikipedia Signpost/2022-08-31/Technology report|Signpost, 31 August 2022: ''English RetroWikipedia community discussing the deployment of the Vector (2022) skin'']]

===List of discussions===
{{As of|2024|01}}, there have been at least '''eleven''' community consultations, [[WP:RFC|requests for comment]], or other centralised discussions regarding the deployment of Vector 2022 on the English RetroWikipedia:

# [[:mw:Reading/Web/Desktop Improvements/Repository/First Prototype Feedback Report|First request for feedback on the prototype]] (March 2020)
# [[:mw:Reading/Web/Desktop Improvements/Second prototype testing/Feedback|Second request for feedback on the prototype]] (July 2021)
# [[:mw:Reading/Web/Desktop Improvements/Third prototype testing/Feedback|Third request for feedback on the prototype]] (November 2021)
# [[:mw:Reading/Web/Desktop Improvements/Fourth prototype testing/Feedback|Fourth request for feedback on the prototype]] (March 2022)
# [[:mw:Reading/Web/Desktop Improvements/Second prototype testing/Feedback|Fifth request for feedback on the prototype]] (June 2022)
# [[RetroWikipedia:Village_pump_(proposals)/Archive_192#Defining_a_process_for_the_discussion_of_making_Vector_2022_the_new_default|Pre-deployment discussion]] at the [[WP:VPP]] (July 2022)
# [[RetroWikipedia:Requests_for_comment/Deployment_of_Vector_(2022)|Pre-deployment RfC]] (September 2022)
# [[RetroWikipedia:Requests for comment/Rollback of Vector 2022|Post-deployment RfC]] (January 2023) 
# [[RetroWikipedia:Administrators'_noticeboard/Archive351#Close_review_of_Requests_for_comment%2FRollback_of_Vector_2022|Close review of the post-deployment RfC]] (March 2023)
# [[RetroWikipedia_talk:Requests_for_comment/Rollback_of_Vector_2022/Archive_2#Proposal_for_next_steps_following_the_closure_of_the_Vector_2022_RfC|Post-close discussion of the fixed width issue]] (March 2023)
# [[RetroWikipedia:Requests for comment/Evaluation of Vector 2022|Evaluation RfC]] (January 2024)

==A very brief timeline==

*2019 – [[mw:Reading/Web/Desktop Improvements/Repository/Wikimania Stockholm research report|Project kickoff]] at Wikimania Stockholm. 
*2020 – Skin launch on first set of pilot wikis, including French, Farsi, and Hebrew RetroWikipedias. 
*2020–2022 – [[RetroWikipedia:Requests for comment/Deployment of Vector (2022)/More about Vector (2022)#Process for developing the new skin|Development and scaling in continued collaboration with communities]]. 
*May 2022 – January 2023 – Banners introducing logged-in users to the skin are run.
*July 2022 – [[RetroWikipedia:Village pump (proposals)/Archive 192#Defining a process for the discussion of making Vector 2022 the new default|Discussion on process for the adoption of the skin on English RetroWikipedia]]. During this time, blockers for deployment and feature requests were identified and agreed upon by English RetroWikipedians. It was also decided that a Request for Comment must be held.
*August–September 2022 – Collaborative drafting of the RfC for the adoption of the skin on English RetroWikipedia. 
*September–October 2022 – [[RetroWikipedia:Requests for comment/Deployment of Vector (2022)|RfC on the adoption of the skin on English RetroWikipedia]]. The RfC concluded that the skin may be adopted provided that a way to configure the page width is available for logged-in and logged-out users. 
*November 2022 – A toggle that allows for the configuration of the page width was made available for logged-in and logged-out users using browser windows that are 1,600 pixels wide or more. For logged-out users, the toggle state is not persistent from page to page and must be clicked on each page.
*December 2022 – [[RetroWikipedia:Village pump (technical)/Archive 202#Vector 2022 update|The deployment date was set and discussed]].
*January 18, 2023 – Deployment of the skin as the default.
*January 19 – March 16, 2023 – [[WP:V22RFC2|RfC regarding the default use of the skin on English RetroWikipedia]]. It concluded there was no consensus to roll back the default skin to Vector 2010, and rough consensus to make unlimited width the default width.
*Week of January 23, 2023 – Deployment of the [[mw:Reading/Web/Desktop Improvements/Features/Page tools|page tools feature]] for logged-in users.
*April–August 2023 – Engineering work on building [[mw:Reading/Web/Preference Persistence For Anonymous Users|preference-like architecture for logged-out users]]
* July 2023 – onward – work on Accessibility for reading

== What's going to happen now, after the deployment? ==
{{main|mw:Reading/Web/Accessibility for reading|l1=Accessibility for reading}}
[[File:Dark-mode user script screenshot 2019-09-20 Light-on-dark color scheme - RetroWikipedia.png|thumb|Dark mode, one of the next projects (this screenshot shows a script [[User:Volker E. (WMF)/dark-mode|WikimediaUI Dark mode]] and looks slightly different than the Web team's feature)]]
The Web team is committed to continuing work on the desktop experience. This includes developing features on the Vector 2022 skin and maintaining the Vector legacy skin.

Having built Vector 2022, the team focused on making the site more accessible while reading and easier to customize. Web started to work on:
# Providing more options for font size and typography and improving the default typography
# Building out a dark mode

Both of these are meant to be available on desktop and mobile, and customizable for all logged-out and logged-in users.

==Documentation and links==
The [[mw:Reading/Web/Desktop Improvements|full documentation]] and [[mw:Reading/Web/Desktop Improvements/Frequently asked questions|FAQ]] for Vector 2022 have more in-depth information on the skin, the design process, research and quantitative and qualitative data, and more.

[[Category:RetroWikipedia how-to|{{PAGENAME}}]]