UX Improuvments
Améliorations possible pour l'UX de la documentation
Services
La liste des services est un peu à l'étroit dans le tableau actuel. On peut:
-
Utiliser des paragraphes avec entêtes -
proposer un template -
valider et appliquer à tous les services -
simplifier le tableau récapitulatif
-
Glossaire/Abréviation
-
peut-être qu'à la place du gloassaire en place qui utilise md-tooltip on pourrait utiliser des abbréviations, c'est natif, à voir si ça nous suffit. -
finir la conversion des @(texte)
entexte
: ma commandesed
a fonctionné mais n'a pas voulu prendre tous les fichiers...
Accueil
-
utiliser un layout landscape pour la page d’accueil -
la rendre accueillante et fun mais pragmatique :) (j'ai fait le strict minimum pour l'instant)
Couleurs
-
avoir une couleur secondaire pour les liens, le violet est ultra redondant et pas hyper lisible partout -
augmenter un peu le contraste pour la lisibilité, peut-être enlever un peu de violet au bg. -
test d’accessibilité avec @ummon
Font
-
Peut-être essayer avec différentes font pour voir si ya pas moyen de faire mieux. Par ex Plex, on peut la patcher fa si besoin. -
test d'accessibilité avec un·e membre du club des taupes.
Organisation du contenu
Utiliser au maximum les possibilités offerte par mkdocs-material. Cf tout le menu de gauche.
-
utiliser les admonitions
-
en créer un custom pour les protocoles -
appliquer à toutes les pages -
personnaliser la couleur des autres admonitions
utilisés quand elle n'est pas harmonieuse avec le reste de nos couleurs (attention
,note
,info
etcitation
pour l'instant)
-
Edited by ornanovitch