Aller au contenu principal

The Future of Documentation

· 5 minutes de lecture
Kirisan Suthanthireswaran
LINCS Software Development Co-op

Info

Cette page web a été traduite automatiquement par DeepL. Bien que nous nous efforcions d’être précis, nous vous informons que les traductions peuvent contenir des erreurs ou des inexactitudes. Pour obtenir les informations les plus précises, veuillez vous référer à la version originale.

Le problème

La documentation fait partie intégrante de tous les produits logiciels et, pour être utile, elle doit être complète et détaillée. Cependant, cela représente un défi à la fois pour les utilisateurs et les développeurs. Les utilisateurs, en particulier ceux qui découvrent le logiciel, peuvent trouver décourageant de passer au crible de gros blocs de texte, tandis que les développeurs ont souvent du mal à rendre la documentation attrayante et digeste.

Tout au long de mes études universitaires, j'ai fait partie de la première catégorie. En tant qu'utilisateur, j'ai toujours trouvé la documentation difficile à comprendre. Elle me laissait souvent avec plus de questions que de réponses. Le fait que les sites web de documentation que j'utilisais avaient souvent une mauvaise navigation et peu de ressources pour m'aider à comprendre ce que je lisais ne m'a pas aidé, me laissant parcourir différents sites pour trouver des informations qui étaient cachées dans un coin.

En tant qu'étudiant coopératif chez LINCS, j'ai été chargé de migrer le site de documentation du Canadian Writing Research Collaboratory (CWRC). Ce site web fournissait des informations sur les trois ontologies développées par le CWRC et permettait d'y accéder, chacune avec son propre ensemble de documentation. Cela m'a inquiété, car comment développer un site web capable d'afficher efficacement la documentation tout en tenant compte de la navigation, de l'esthétique et de la mise en page ?

Invisible to the Sighted, Barrier to the Blind

· 6 minutes de lecture
Humna Chaudhry
LINCS Undergraduate Research Assistant

Info

Cette page web a été traduite automatiquement par DeepL. Bien que nous nous efforcions d’être précis, nous vous informons que les traductions peuvent contenir des erreurs ou des inexactitudes. Pour obtenir les informations les plus précises, veuillez vous référer à la version originale.

J'ai passé la majeure partie de mon été à améliorer l'accessibilité du site web du projet LINCS. Au cours de ce processus, j'ai beaucoup appris sur la façon dont les personnes handicapées naviguent sur Internet. Il y a eu beaucoup à faire et cela m'a pris beaucoup de temps, mais ce n'est pas une fatalité ! Si les concepteurs intègrent l'accessibilité dès le départ, un effort supplémentaire minime permet d'améliorer l'expérience de tous les utilisateurs, et pas seulement de ceux qui ont des barrières.

L'essentiel, c'est le peuple

· 5 minutes de lecture
Susan Brown
Chef de projet LINCS

Opératrices de cartes perforées

Image: Opératrices de cartes perforées travaillant sur l'Index Thomisticus de Roberto Busa. En arrière à gauche : Rosetta Rossi Bertolli ; en bas à droite : Livia Canestraro. CC-BY-NC. Merci à Melissa Terras, "For Ada Lovelace Day," 2015.

Info

Cette page web a été traduite automatiquement par DeepL. Bien que nous nous efforcions d’être précis, nous vous informons que les traductions peuvent contenir des erreurs ou des inexactitudes. Pour obtenir les informations les plus précises, veuillez vous référer à la version originale.

Je suis surpris et ravi que quelqu'un ait jugé utile de me proposer pour le Prix Roberto Busa, et ravi d'avoir été placé par ADHO en si illustre compagnie, tout en étant pleinement conscient qu'il y a tant de superbes travaux dans notre communauté qui méritent cette reconnaissance.

Toute connaissance est relationnelle. Il est fabuleux de voir reconnue une recherche qui émerge d'une perspective intersectionnelle et qui s'inscrit dans un processus : de la fabrication d'objets qui tentent d'exploiter la technologie de manière nouvelle, en essayant et en échouant, mais en continuant à essayer de faire une différence dans notre manière de travailler et de nous permettre de créer et de partager des connaissances ensemble, de manière plus efficace, dans un monde en mutation. Pour un tel travail, la collaboration est essentielle, ce qui revient à dire qu'il s'agit avant tout de personnes.

Mes excellents collègues du LINCS ont formé une équipe phénoménale, même si nous nous sommes réunis à distance, beaucoup d'entre nous pour la première fois, au plus fort de la pandémie, afin de mettre en place une infrastructure permettant de relier les connaissances savantes entre les disciplines. L'équipe principale du LINCS est au cœur d'un réseau croissant de chercheurs, d'étudiants et de professionnels qui, grâce aux efforts combinés de ces personnes brillantes, sont en mesure d'explorer sérieusement la capacité des données liées à améliorer la recherche culturelle et les expériences culturelles. L'environnement de recherche virtuel du CCRF a impliqué plus de 200 personnes formidables (et ce n'est pas fini, car nos crédits doivent être mis à jour avant que nous ne lancions ce printemps une instance du cadre logiciel LEAF). Et ma foi en la magie de la production collaborative de connaissances par de nouveaux moyens numériques est née d'une expérience formatrice en tant que nouveau chercheur dans le projet Orlando, dont les participants remarquables comprennent ~150 étudiants.

Ce ne sont pas les chiffres qui comptent, mais le sentiment d'expansion des réseaux : il y a des chevauchements entre les projets et les rôles, de sorte que le décompte n'est pas exact, voire ne peut jamais l'être, parce qu'il y aura inévitablement des omissions involontaires et parce que les fils d'influence ne cessent de se relier les uns aux autres. Je suis très reconnaissante pour toutes les relations riches qui imprègnent ce travail, étonnée de ce que nous avons créé et appris ensemble, fière de ceux qui l'ont mis en œuvre dans d'autres contextes et d'autres domaines.

Et il y a tant d'autres relations, d'autres personnes à qui il faut rendre hommage. Des mentors qui renforcent ma confiance. Des modèles dont la pensée et les pratiques éclairent et inspirent les miennes. Des co-auteurs et des co-présentateurs qui m'aident à voir les choses différemment alors que nous nous efforçons de nous exprimer ensemble. Les étudiants et les collègues des cours et des ateliers dont les réactions et les questions suscitent une telle perspicacité. Des collègues qui continuent et restent dévoués malgré la précarité déplorable des conditions dans lesquelles ils travaillent. Les collaborateurs de projets dirigés par d'autres, dans lesquels j'ai tant appris, notamment Collective Biographies of Women, INKE, Lesbian and Gay Liberation in Canada, NovelTM, Staging Better Futures/Mise en scène de meilleurs avenirs, The People and the Text, Voyant, The People and the Text et le Women Writers Project. Les créateurs et les activistes dont le travail reflète, réimagine et remodèle le monde dans lequel nous vivons.

Tant d'autres projets qui ont travaillé avec le CWRC et LINCS, et l'incroyable éventail d'initiatives en matière d'humanités numériques dans le monde entier, qui travaillent collectivement pour trouver comment produire et partager le savoir différemment à l'ère des incunables. Les membres de l'administration universitaire - aux universités de Guelph, Alberta et à de nombreuses universités partenaires - ainsi que les organismes de financement - FCI, CANARIE, DRAC, Mellon, CRSH - qui comprennent que ce travail n'entre pas dans les vieux moules, qui s'efforcent d'éliminer les obstacles et qui élaborent de nouveaux modèles. Les collègues qui veillent à ce que les organisations scientifiques telles que CSDH, ACH, ADHO, ACCUTE, ACQL, MLA, BWWA, VSAWC et NAVSA fonctionnent de manière à ce que nous disposions d'espaces collégiaux dans lesquels nous pouvons nous connecter. Des collègues qui siègent dans des groupes et des conseils d'administration et qui m'aident à appréhender la situation dans son ensemble et à comprendre les autres points de vue. Les partenaires du GLAM et de l'écosystème de la connaissance, comme le CRKN, le CHIN et la Bibliothèque et Archives Canada, qui partagent la vision de ce qu'il est possible de faire si nous travaillons ensemble.

Tous ceux qui, dans ce réseau particulier, sont motivés par le sentiment que la complexité et la valeur des cultures et des histoires humaines - en particulier celles des femmes, des BIPOC, des colonisés, des 2SLGBTQI+, des pauvres et des autres personnes marginalisées - pourraient s'inscrire dans l'espace numérique de manière différente, plus vivante, plus nuancée, plus contextualisée, plus respectueuse et plus équitable.

Concevoir et réaliser des applications web réactives

· 5 minutes de lecture
Marco Lian Bantolino
Coopérative de développement de logiciels LINCS

Info

Cette page web a été traduite automatiquement par DeepL. Bien que nous nous efforcions d’être précis, nous vous informons que les traductions peuvent contenir des erreurs ou des inexactitudes. Pour obtenir les informations les plus précises, veuillez vous référer à la version originale.

Lors de la conception et de la réalisation d'une application web, il est primordial de veiller à ce qu'elle soit réactive. Une application réactive est belle et fonctionne bien sur toutes les tailles d'écran et tous les appareils. Les applications LINCS sont conçues pour être visualisées de différentes manières : des tablettes aux ordinateurs portables en passant par les écrans interactifs de la taille d'un tableau blanc. Il peut être difficile d'atteindre ce niveau de réactivité, mais avec l'aide d'outils, de techniques et de cadres CSS, la tâche devient beaucoup plus facile...

Glaces, binaires et hypothèses

· 7 minutes de lecture
Jingyi Long
LINCS Assistant de recherche de premier cycle

Info

Cette page web a été traduite automatiquement par DeepL. Bien que nous nous efforcions d’être précis, nous vous informons que les traductions peuvent contenir des erreurs ou des inexactitudes. Pour obtenir les informations les plus précises, veuillez vous référer à la version originale.

Lors de ma première réunion cet été en tant qu'assistant de recherche en science des données, nous avons tous suivi nos présentations personnelles en déclarant nos parfums de crème glacée préférés. Le mien était et est toujours la glace Häagen Dazs' Strawberry Cheesecake, et j'ai été agréablement surprise d'apprendre que quelqu'un d'autre dans l'équipe était du même avis. Cependant, la plus grande surprise a été d'apprendre que quelqu'un aimait passer sa glace au micro-ondes pour en modifier la texture. À ce moment-là, est-ce encore de la glace ? Est-ce une soupe ? Ou un milkshake ? Qu'est-ce qui est considéré comme de la crème glacée ? ...

Reconstituer le passé avec LOD

· 5 minutes de lecture
Aliza Ferrone
LINCS Assistant de recherche de premier cycle

Info

Cette page web a été traduite automatiquement par DeepL. Bien que nous nous efforcions d’être précis, nous vous informons que les traductions peuvent contenir des erreurs ou des inexactitudes. Pour obtenir les informations les plus précises, veuillez vous référer à la version originale.

J'ai toujours trouvé que le contexte changeait tout lorsqu'on apprenait quelque chose de nouveau, en particulier lorsqu'il s'agissait de comprendre pourquoi cette chose était importante. Le premier exemple qui me vient à l'esprit est celui des cours de chimie générale que j'ai suivis et dont les concepts n'ont jamais vraiment fait mouche, pas plus que je n'ai compris pourquoi je devais les apprendre. Quatre de ces cours plus tard, je n'étais pas très enthousiaste à l'idée de suivre un cours de biochimie, mais lorsque je l'ai fait, je n'arrivais pas à croire à quel point cela faisait une différence d'avoir un contexte réel : le corps humain, où les réactions chimiques se produisent pour une raison. Tout d'un coup, l'abstrait est devenu très important - je pouvais voir comment tout cela s'emboîtait, et en retour, ma compréhension de la chimie générale a probablement été multipliée par trois. Rassurez-vous, cet article de blog ne va pas parler de chimie. Il s'agit plutôt de montrer comment le même phénomène s'est produit cet été, lorsque le travail sur le projet Orlando a changé ma façon de penser les données...

Le développement par étapes: Apprendre à collaborer sur un projet technique

· 3 minutes de lecture
Basil Yusef
LINCS Assistant de recherche de premier cycle en informatique

Info

Cette page web a été traduite automatiquement par DeepL. Bien que nous nous efforcions d’être précis, nous vous informons que les traductions peuvent contenir des erreurs ou des inexactitudes. Pour obtenir les informations les plus précises, veuillez vous référer à la version originale.

LINCS utilise ResearchSpace comme plateforme pour explorer les relations dans les ensembles de données culturelles interconnectées. Avec ResearchSpace, les chercheurs peuvent parcourir, rechercher et visualiser des données dans le dépôt de données du LINCS. Durant l'été 2022, j'ai fait partie d'une équipe qui développait de nouvelles fonctionnalités pour la version de ResearchSpace du LINCS.

Notre équipe était une collaboration entre des contributeurs ayant une expérience de l'expérience utilisateur (UX) et des contributeurs ayant une expérience du développement de logiciels. Nous avons travaillé en tandem : le groupe UX a recommandé des fonctionnalités pour améliorer l'expérience d'utilisation de l'application web. Ces recommandations ont été transformées en tickets dans GitLab. Les tickets décrivaient le produit final souhaité et il incombait aux développeurs de déterminer comment atteindre cet objectif. Le responsable du développement a réparti les tickets entre les développeurs de logiciels, en les divisant en fonction de ce qui serait nécessaire pour construire les fonctionnalités suggérées...

Les merveilles de la communication API: L'outil de vérification NLP Diffbot

· 6 minutes de lecture
Mohammed Marzookh
LINCS Analyste de recherche junior
Ananya Rao
LINCS Analyste de recherche junior

Info

Cette page web a été traduite automatiquement par DeepL. Bien que nous nous efforcions d’être précis, nous vous informons que les traductions peuvent contenir des erreurs ou des inexactitudes. Pour obtenir les informations les plus précises, veuillez vous référer à la version originale.

Si vous avez déjà écouté une conversation technique entre informaticiens, vous les avez peut-être entendus parler de ce qu'on appelle une Application Programming Interface (API). Qu'est-ce qu'une API ? Décortiquons-le...

Recherche et conception pour l'actionnabilité

· 6 minutes de lecture
Jordan Lum
LINCS UX Co-op

Info

Cette page web a été traduite automatiquement par DeepL. Bien que nous nous efforcions d’être précis, nous vous informons que les traductions peuvent contenir des erreurs ou des inexactitudes. Pour obtenir les informations les plus précises, veuillez vous référer à la version originale.

L'équipe UX a mené des recherches auprès des utilisateurs sur les outils LINCS afin de les préparer à passer du développement à la production. Jusqu'à présent, nous avons effectué des tris de cartes, des tests de convivialité, des enquêtes et des entretiens. Ces recherches nous ont fourni une mine d'informations. Cependant, si nous voulons traduire ce que nous avons appris en changements significatifs et productifs dans la conception des outils, nous devons garder l'actionnabilité au centre de notre pratique de recherche...

Stand-up pour le développement de logiciels

· 4 minutes de lecture
Eason Liang
Coopérative de développement de logiciels LINCS

Info

Cette page web a été traduite automatiquement par DeepL. Bien que nous nous efforcions d’être précis, nous vous informons que les traductions peuvent contenir des erreurs ou des inexactitudes. Pour obtenir les informations les plus précises, veuillez vous référer à la version originale.

Lorsque j'ai commencé mon premier stage coopératif, je n'avais aucune idée de la manière dont le développement de logiciels fonctionnait dans un environnement professionnel. Auparavant, je n'avais fait l'expérience que de la salle de classe, où mes camarades et moi-même développions des logiciels pour des travaux. Lorsque j'ai intégré un contexte professionnel, j'ai découvert de nouvelles méthodes de collaboration, notamment les réunions debout (stand-up meetings) ou les réunions debout (stand-ups)...