Page MenuHomePhabricator

[ToC] test "show all sub-sections" button
Closed, DeclinedPublic

Description

Description

One of the things we asked the community about during testing was whether sub-sections should be shown or hidden by default within the table of contents. Preferences varied, and were somewhat dependent on which article someone is looking at (which led to T300973). A related request that came up, for the case where sub-sections are hidden — a button at the top of the ToC would show/expand all sub-sections within the ToC. This would allow people to easily make the ToC fully expanded (rather than having to expand section-by-section).

Here is a video of how that could look:

Testing

We ran two basic tests on usertesting.com, with 5 participants in each test:

Test 1) In the first test people were taken to several articles and asked to navigate to particular sections and sub-sections using the table of contents.

Test 2) In the second test people were asked about their expectations regarding what clicking on certain items within the table of contents would do. They were then asked to explore clicking the various buttons. Then finally they were taken to several articles and asked to navigate to particular sections and sub-sections using the table of contents.

the key difference between the two tests was that they participants in Test 2 were made aware of the "show/hide all sub-sections" button up-front (i.e. before the "tasks" began).

Findings

Test 1) all 5 participants were able to easily use the table of contents to navigate to the requested sections & sub-sections (either by clicking on the section heading, or using the section toggle to expand it then clicking on the sub-section).

Test 2)

  • all 5 participants correctly guessed what clicking on a section title, and what clicking on a section toggle would do
  • None of the 5 participants correctly guessed what clicking on the hide/show all sub-sections button would do
  • During the section & sub-section navigation tasks the participants used a mix of the hide/show all button, and the individual section toggle buttons, to discover the requested sub-sections
  • All 5 participants responded that they liked the hide/show all button

Conclusion

  • The hide/show all button does not seem necessary for being able to find a given sub-section
  • The hide/show all button is not discoverable, or clear, in its current form
  • People use the hide/show all button once they know about it, though it doesn't necessarily help them navigate more quickly

As @RHo mentioned there may be a need/desire around using the table of contents as a map to get a sense of the article, and wanting a more detailed map (so to speak) by showing all sub-sections. This seems like a worthwhile need/desire to test, though I'm not yet sure how we could test that.

Event Timeline

alexhollender_WMF updated the task description. (Show Details)

based on the findings we've decided not to add this functionality to the table of contents, though we encourage our future selves (and other future teams/collaborators) to continue exploring the possible needs here, and/or consider adding this as optional functionality controlled via a preference.

Declining for the time being.

Please install a "Show subsections" or "Expand all" button in Vector 2022 table of contents. Next to the "move to sidebar" button. See archived Village Pump discussion:
https://en.wikipedia.org/wiki/Wikipedia:Village_pump_(technical)/Archive_206#Button_to_expand_table_of_contents_in_Vector_2022

The only reason I may not be using Vector 2022 is because of the lack of an expanded table on contents on long articles. I am sure I am not the only one. See that thread.

Look at almost any US president article. They are long articles. There are many more. IP readers are forced to endure this closed TOC on long articles. This is a big step backward for Wikipedia. Wikipedia is known for ease of use, and simplicity. IP readers can't change the skin.

The TOC overlay is the best feature of Vector 2022. Especially the fact that the link for it is sticky and remains visible at the top of the page as one scrolls down the page.

The TOC is crippled though by the lack of a "show subsections" or "expand all" or "Show all" button. The button needs to be a text button. Not a symbol. Otherwise far fewer people will discover it.

The "Conclusion" section here is the opposite of what the "Findings" section says. The Conclusion section says: "though it doesn't necessarily help them navigate more quickly".

"Findings" section says: "All 5 participants responded that they liked the hide/show all button". They must be liking it for something. Like the ability to rapidly scan what is in a long article. That is a form of general navigation.

An admin at the Village Pump asked for a single link to expand the entire table of contents for this page:
https://en.wikipedia.org/wiki/Wikipedia:ITNC
See this archived Village Pump thread:
https://en.wikipedia.org/wiki/Wikipedia:Village_pump_(technical)/Archive_206#New_Vector_2022_Skin_Navigation_Bar_(Table_of_Contents)_--_Expanded_View

More and more people at the Village Pump are asking for this. Several admins and others are working on some JS and CSS customizations to do this.

A good one is installed by putting the code below in one's vector-2022.js page:
https://en.wikipedia.org/wiki/Special:MyPage/vector-2022.js

importScript('User:The wub/tocExpandAll.js');

See: https://en.wikipedia.org/wiki/User:Timeshifter/vector-2022.js
https://en.wikipedia.org/wiki/User:The_wub/tocExpandAll.js
https://en.wikipedia.org/wiki/User:The_wub/tocExpandAll.css

Another great improvement is to decrease the line spacing in the TOC. There is different CSS code for Vector 2022 and Vector 2010. See:
https://en.wikipedia.org/wiki/User:Timeshifter/vector.css
https://en.wikipedia.org/wiki/User:Timeshifter/vector-2022.css
https://en.wikipedia.org/wiki/Wikipedia:Village_pump_(technical)/Archive_206#Lessen_line_spacing_in_long_or_expanded_table_of_contents

Please reconsider adding this. Having to open every section manually is tedious, especially on project pages.

I fail to understand how you concluded with "The hide/show all button does not seem necessary" from "All 5 participants responded that they liked the hide/show all button". It would be incredibly useful in navigating large pages, especially https://en.wikipedia.org/wiki/Wikipedia:In_the_news/Candidates.

A lot of people still want an "expand all, collapse all" toggle.

The JS import mentioned in my previous post here alternates between labels: Expand all and Collapse all.

The label solves the problem mentioned: "None of the 5 participants correctly guessed what clicking on the hide/show all sub-sections button would do." My understanding is that the toggle in the test was not labeled.

In the other test they were told what the toggle did, and they liked it: "All 5 participants responded that they liked the hide/show all button".

Another test is needed using a labeled toggle. Try the JS import to see what to test. Even without the label people liked the toggle.

And one test needs to ask people to look around a long article with many sections and subsections, and use the TOC to help out. Ask them what they think of the TOC with the labeled toggle.

The previous tests asked them to do this: "asked to navigate to particular sections and sub-sections using the table of contents." In that case expanding all is not always necessary.

But if you are browsing an article without knowing exactly what you are looking for an expanded TOC can be very helpful and interesting. Even if you know what you are looking for you may need to expand all in order to see how what you are looking for is called in the article headings.

See related Phabricator task T333801: Vector 2022: consider showing closed sections of the TOC by default