Reading/Web/Desktop Improvements/Features/Table of contents/fr

L'un des principaux objectifs du projet des Améliorations du bureau est de rendre les outils fréquemment utilisés plus accessibles aux lecteurs et aux rédacteurs. Le Sommaire, c'est l'un des plus cruciaux de ces outils. Cette fonctionnalité joue deux rôles importants. Il donne des informations sur le contexte et permet de naviguer à l'intérieur des pages.

Actuellement, le Sommaire est disponible seulement tout en haut de la page et cela limite son utilité. Nous avons en programme de le rendre persistant, toujours disponible sur la page. Notre objectif est de faciliter l'accès des lecteurs et des contributeurs au Sommaire. Nous voulons qu'il soit plus facile de comprendre le contexte du contenu et de naviguer dans la page sans avoir à la faire défiler jusqu'en haut.

Contexte et objectifs
Nous aimerions que l'interface, y compris les éléments de navigation, soit plus facile à utiliser. Jusqu'à présent, nous avons créé une barre latérale repliable et un entête figé. Maintenant, nous sommes en train de préparer un nouveau Sommaire.

Actuellement :


 * L'actuel Sommaire est disponible seulement tout en haut de la page. Il est difficile de se repérer et de naviguer dans la page sans devoir la faire défiler vers le haut
 * Pour les pages qui ont une longue section d'introduction, le Sommaire n'est visible qu'en faisant défiler un peu la page vers le bas
 * Les utilisateurs se servent du Sommaire pour se créer un modèle mental de la page. Il a un rôle similaire à celui de l'introduction par rapport à l'article dans son ensemble. Les utilisateurs apprennent ainsi ce que la page contient, sa longueur, quelles sont les parties les plus longues, etc. Cela se perd sans la possibilité de s'en remettre au Sommaire plus fréquemment.
 * Le Sommaire crée beaucoup d'espace inutilisé dans la zone du contenu. Cet espace pourrait être utilisé pour afficher le contenu et d'autres fonctionnalités.

Avec le nouveau Sommaire fixe, il sera plus facile pour les lecteurs de


 * Comprendre le contexte de la page
 * Consulter différentes sections de la page sans à avoir à faire défiler la page vers le haut chaque fois qu'ils veulent accéder au Sommaire.

Cas d'utilisation

 * En tant que lecteur ou rédacteur, je veux être en mesure de comprendre le contexte (contenu et structure) de la page que je vais lire
 * En tant que lecteur ou rédacteur, je veux avoir la possibilité de consulter les sections suivantes à n'importe quel endroit de la page, afin de pouvoir choisir ce que je vais lire ensuite
 * En tant que lecteur ou éditeur, je veux avoir la possibilité de savoir combien de sections a une page, sans avoir à la faire défiler jusqu'en haut

Description et prérequis de la fonctionnalité
Le Sommaire apparaitra fixé à côté de la page. Il contiendra toutes les sections et les sous-sections disponibles dans les précédentes versions du Sommaire.

Le Sommaire contiendra les fonctionnalités suivantes :


 * Sous-sections repliables - pour les utilisateurs qui ne souhaitent voir que les niveaux les plus élevé de l'intitulé de la section
 * Mise en gras de la section - la section de la page en train d'être consultée s'affichera en gras Users will be able to identify where on the page they are located by noting the bolding within the ToC
 * Navigation - selecting a section within the table of contents will navigate to the appropriate section within the page
 * For screen widths smaller than 1000px, the ToC will collapse and the section titles will be used as a ToC



Prototype
General ToC functionality: https://en-toc.wmcloud.org/wiki/Moon

Collapsible section functionality: https://di-toc-collapsible-sections.web.app/Aretha_Franklin

Tests utilisateur avec des lecteurs et des contributeurs
We performed user testing of the table of contents with readers and editors. The tests took place in three locations (Argentina, Ghana, Indonesia) and different languages. The participants were asked to interact with different versions of a persistent table of contents. Their task was to give feedback on their preferred version. The test also included an open study of the way readers and editors saw and used the table of contents.

All users found the table of contents to be essential to the reading experience. They needed it for both navigational purposes as well as for setting the context for the page.

Main observations: Testers liked getting a sense of location within the page. They noted that additions like bolding the title or the section helped with their orientation
 * Testers preferred persistent access. Across all tests, the best prototype was the persistent one
 * Testers preferred having more information. Prototypes that contained all sections and subsections gained more positive opinions
 * Testers did not want the ToC to overlap the content. Even in the cases where it was supplementary to the main ToC at the top of the page

The results of the test were used to select the best prototype. Next, we worked on it to better fit the needs of the participants. See the full results of this test.

Test du prototype avec des contributeurs
In December 2021, we performed prototype testing with logged-in users across 30 wikis. We designed the test to gather feedback on the usability and functionality of the table of contents. The majority of the feedback was positive. Most community members like the new location and functionality of the table of contents, and support the change.

Évaluation quantitative
We will be performing an A/B test of the functionality of the current versus new version of the table of contents.

Main questions:
 * 1) Is the new table of contents is used more frequently than the previous table of contents
 * 2) Does the new table of contents reduce the need to scroll back to the top of the page
 * 3) Does the new table of contents decrease the time people spend scrolling/scrolling quickly (if possible)
 * 4) How does the new table of contents affect the time spent on a page

FAQ
The table of contents feature is still in active development.

Why doesn't the table of contents doesn't work well on my mobile device or when I resize the browser?
Users on mobile and resized browsers account for a small fraction of page traffic, so because of this we prioritized building the feature for the majority of our users first. For narrow screens we plan to make the table of contents available as a sticky interface element that's accessible from anywhere in the page. This is being built as part of https://phabricator.wikimedia.org/T306660 with a current release date of early August 2022.

Note what is displayed to mobile devices differs from what you see when you resize your browser. On mobile devices, the site is currently presented as a zoomed out version of the desktop site.

Why can't I collapse the table of contents?
The feature is still in development. We plan to make it possible to collapse the table of contents. This will be handled in https://phabricator.wikimedia.org/T307901.

Why doesn't it appear when I complete an edit?
The feature is still in development. This will be fixed in https://phabricator.wikimedia.org/T307251 with a planned timeline of end of August 2022.

How can I get the old table of contents?
We intentionally do not add the old table of contents to the article in addition to the new sidebar location. This is because it increases the overall size of HTML that is shipped to clients, increases the storage requirement for our parser cache, and requires additional CSS to render. It's a trade off we've taken to reduce the work involved maintaining the code and keeping the site optimized.

Users can restore the old table of contents position with the following JavaScript code:

How do magic words work with this feature?
The magic word will not work in Vector 2022 as the table of contents is always in the sidebar and this cannot be changed. However magic words relating to presence of table of contents will continue to work i.e. an article can disable the default table of contents and apply its own if necessary.

All magic words will continue to work for other skins which render the table of contents within the article.

I can't see the table of contents when the sidebar is open on tablet/mobile device
This is a known problem for now. The sidebar should be closed by default unless you opened it, so this issue should only impact logged in users who have opened the sidebar. On the long term, we plan to reduce the size of this menu, and make the sidebar overlay content. Details and a prototype of how that will look can be found in T302073. This change is planned in the latter part of the year, and further information can be found on Reading/Web/Desktop_Improvements/Features/Page_tools (October-December).