Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Préserver et rendre identifiables les logiciels de recherche avec Software Heritage #616

Open
marie-flesch opened this issue May 2, 2024 · 85 comments

Comments

@marie-flesch
Copy link
Contributor

marie-flesch commented May 2, 2024

Programming Historian en français a reçu une proposition de leçon originale intitulée "Préserver et rendre identifiables les logiciels de recherche avec Software Heritage", de la part de Sabrina Granger, Baptiste Mélès et Frederic Santos.

Cette leçon a trois objectifs pédagogiques principaux :

  1. Comprendre les enjeux de l'archivage du code source des logiciels de recherche, et ses spécificités par rapport aux jeux de données.
  2. Archiver des logiciels, qu'ils soient écrits par vous-même ou par un.e collègue.
  3. Comprendre les différents besoins d'identification inhérents au logiciel. Obtenir et utiliser des identidiants intrinsèques pour une meilleure reproductibilité de ses travaux.

La proposition a été évaluée et acceptée par l'équipe de Programming Historian en français. Elle répond à nos critères en termes de science ouverte et de pérennité.

La leçon sera envoyée par ses auteurices fin mai 2024. À sa réception, son suivi éditorial sera confié à un·e des membres de l'équipe de Programming Historian en français.

Si nous n'avons pas reçu la leçon à la date convenue, nous contacterons ses auteurices. En cas de non-réponse, nous fermerons ce ticket.

Programming Historian en français a pour but d'offrir un environnement académique ouvert, qui permet aux membres de la communauté de se sentir libres d'examiner des idées en détail, de poser des questions, de faire des suggestions, ou de formuler des demandes de clarification. Nous insistons sur l'importance de faire en sorte que cet espace de discussion reste respectueux et exempt de tout harcèlement pour tous les contributeur(trice)s, quels que soient leur genre, leur identité et leur expression de genre, leur orientation sexuelle, leur handicap, leur apparence physique, leur masse corporelle, leurs origines, leur âge, leur religion, ou leur expérience technique. Nous ne tolérons pas, sous quelque forme que ce soit, le harcèlement ou les attaques ad hominem contre les membres de la communauté. Les participant·es qui violeraient ces règles pourront être exclu·es de la communauté à la discrétion du comité éditorial. Si quelqu'un est témoin ou pense avoir été victime des agissements décrits plus haut, veuillez prendre contact avec notre médiatrice Hélène Huet. Merci de nous aider à créer un espace de discussion et d'échange sûr. Contacter notre médiatrice n'a aucun impact sur l'issue du processus d'évaluation par les pairs.

@marie-flesch
Copy link
Contributor Author

Nous avons reçu la leçon, et @DMathelier s'est proposée pour en assurer le suivi ✨

@marie-flesch
Copy link
Contributor Author

Les auteurices de la leçon sont @sabrinagranger, @BapMel et @frederic-santos.

@anisa-hawes anisa-hawes moved this from 0 Proposal to 1 Submission in Active Lessons Jun 12, 2024
@charlottejmc
Copy link
Collaborator

charlottejmc commented Jun 13, 2024

Bonjour @DMathelier, @sabrinagranger, @BapMel et @frederic-santos,

Vous trouverez les fichiers ici :

Vous pouvez parcourir l’aperçu de la soumission ici :


  • I noticed that the file for Figure 5 citar_GitHub.png was not included in the image folder, which only contained citar_GitHub_raw.png. Would you like me to use this one? If not, could you please send the image to my address publishing.assistant[@]programminghistorian.org? Merci !
  • I have added a field to the liquid syntax for our images: alt="Visual description of figure image".

This descriptive element enables screen readers to read the information conveyed in the images for people with visual impairments, different learning abilities, or who cannot otherwise view them, for example due to a slow internet connection. It's important to say that alt-text should go further than repeating the figure captions.

We have found Amy Cesal's guide to Writing Alt Text for Data Visualization useful. This guide advises that alt-text for graphs and data visualisations should consist of the following:

alt="[Chart type] of [data type] where [reason for including chart]"

What Amy Cesal's guide achieves is prompting an author to reflect on their reasons for including the graph or visualisation. What idea does this support? What can a reader learn or understand from this visual?

The Graphs section of Diagram Center's guidance is also useful. Some key points (relevant to all graph types) we can take away from it are:

  • Briefly describe the graph and give a summary if one is immediately apparent
  • Provide any titles and axis labels
  • It is not necessary to describe the visual attributes of the graph (colour, shading, line-style etc.) unless there is an explicit need
  • Often, data shown in a graph can be converted into accessible tables

For general images, Harvard's guidance notes some useful ideas. A key point is to keep descriptions simple, and adapt them to the context and purpose for which the image is being included.

Would you feel comfortable making a first draft of the alt-text for each of the figures? This is certainly a bit time-consuming, but we believe it is very worthwhile in terms of making your lesson accessible to the broadest possible audience.

Merci !

@anisa-hawes anisa-hawes moved this from 1 Submission to 2 Initial Edit in Active Lessons Jun 13, 2024
@anisa-hawes
Copy link
Contributor

anisa-hawes commented Jun 13, 2024

Bonjour Sabrina @sabrinagranger, Baptiste @BapMel, and Frédéric @frederic-santos,

What's happening now?

Your lesson has been moved to the next phase of our workflow which is Phase 2: Initial Edit.

In this phase, your editor Daphné @DMathelier will read your lesson, and provide some initial feedback. Daphné will post feedback and suggestions as a comment in this issue, so that you can revise your draft in the following phase (Phase 3: Revision 1).

%%{init: { 'logLevel': 'debug', 'theme': 'dark', 'themeVariables': {
              'cScale0': '#444444', 'cScaleLabel0': '#ffffff',
              'cScale1': '#3d7c81', 'cScaleLabel1': '#ffffff',
              'cScale2': '#444444', 'cScaleLabel2': '#ffffff'
       } } }%%
timeline
Section Phase 1 <br> Submission
Who worked on this? : Publishing Assistant (@charlottejmc) 
All  Phase 1 tasks completed? : Yes
Section Phase 2 <br> Initial Edit
Who's working on this? : Editor (@DMathelier)  
Expected completion date? : July 14
Section Phase 3 <br> Revision 1
Who's responsible? : Authors (@sabrinagranger, @BapMel, @frederic-santos) 
Expected timeframe? : ~30 days after feedback is received
Loading

In the meantime, I've sent you each an invitation to join us as Outside Collaborators here on GitHub. This will give you the 'write access' you'll need to edit your alt-text as Charlotte suggests above. Your lesson file is here: /fr/en-cours/originales/preserver-logiciels-recherche.md, and you can edit it directly.

Note: The Mermaid diagram above may not render on GitHub mobile. Please check in via desktop when you have a moment.

@frederic-santos
Copy link
Collaborator

frederic-santos commented Jun 17, 2024

Bonjour à toute l'équipe PH : @DMathelier, @anisa-hawes, @marie-flesch et @charlottejmc !

Je viens de pousser un nouveau commit qui devrait résoudre (j'espère !) vos commentaires et suggestions ci-dessus. Merci pour votre première relecture !

  • Pour la Fig. 5, il s'agissait bien du fichier citar_GitHub_raw.png : mes excuses.

  • Étant donné que presque toutes nos images sont des gifs animés dont la description textuelle précise n'est pas évidente, j'ai fait au mieux pour les balises alt-text. Lorsque cela était possible, j'ai essayé d'être assez spécifique en peu de mots. Parfois, c'était difficile de décrire précisément les manipulations montrées sur le gif, et je suis donc resté plus évasif. J'espère que cela correspondra quand même à peu près à ce que vous attendiez.

Of course, mes co-auteurs @sabrinagranger et @BapMel peuvent également m'engueuler si ce n'est pas le cas ;)

À bientôt et merci !

@DMathelier
Copy link
Contributor

DMathelier commented Jun 18, 2024

Bonjour Sabrina @sabrinagranger, Baptiste @BapMel, and Frédéric @frederic-santos,

J’ai fini de relire votre leçon, un grand merci pour votre travail très utile !

Avant que nous passions à la phase d’évaluation j’ai des remarques et améliorations à vous proposer. Désolée d’avance pour le pavé mais il s’agit des corrections habituelles et vous êtes libres de ne pas toutes les accepter évidemment :)

Interrogations

Propositions de correction

  • §7 : Leurs conditions d’utilisation peuvent être modifiées, de sorte que les espaces de travail fonctionnant avec une technologie donnée ne soient plus maintenusLeurs conditions d’utilisation peuvent être modifiées et les espaces de travail fonctionnant avec une technologie donnée ne seraient alors plus maintenus

  • §21 et §43 : remplacer le point d’interrogation à la fin du paragraphe par un point.

  • § 24 : revoir la formulation du commencement de la liste (+ ajout de majuscules en début de ligne et de points en fin de chaque ligne)

Software Heritage fournit aussi :
- Des contenus publics [...] Google Code.
- Des contenus des forges [...] dans l’archive.
- Des codes sources associés [...] et technologies.
- Des codes sources de logiciels [...] publiés ou non.
  • §28 : chaque modification peut être documentée via une révision, ou commit en anglaischaque modification peut être documentée à l’aide d’une « révision » (*commit*)

  • §38 : OrcidORCID

  • §40 : commencer la citation par numéro (supprimer C’est un)

  • [name=sabrina] a ajouté une majuscule en début de citation

  • §41 : remplacer un des ayant pour éviter le recours à ce mot deux fois sur deux lignes consécutives

  • §45 : agencement du tableau à revoir

    • Ajouter une colonne à gauche avec les intitulés suivants (un par ligne) : Objectif, Nécessité (ou Besoin, Prérequis, etc.), Type d’identifiant, Analogie, Obtention de l’identifiant
  • [name=sabrina]: changement effectué 2024-07-10

  • §49 : cas présentcas présent

  • @BapMel: §51 et suivants (pour chaque cas d’étude) : remplacer chaque puce par un paragraphe ? (Il me semble que cela favoriserait la lisibilité de l’ensemble)

1. Si vous ne connaissez que le _nom du projet_, par exemple «&nbsp;Linux&nbsp;», le plus simple est de chercher son dépôt officiel dans un moteur de recherche ou un catalogue de logiciels (ex. [catalogue des logiciels du MédiaLab de SciencesPo](https://medialab.sciencespo.fr/outils/)). Par exemple, en tapant «&nbsp;Linux source code&nbsp;» dans un moteur de recherche, vous tomberez assez rapidement sur une page intitulée «&nbsp;GitHub - torvalds/linux: Linux kernel source tree&nbsp;» à l’adresse <https://github.com/torvalds/linux>. Cette adresse est celle de l’«&nbsp;origine&nbsp;», c’est-à-dire du dépôt distant de référence. Elle permet de retrouver très facilement le code source sur Software Heritage, comme vous le verrez dans le point 4 ci-dessous.

Remplacer par

##### Option 1. Vous ne connaissez que le _nom du projet_

Le plus simple est de chercher son dépôt officiel dans un moteur de recherche ou un catalogue de logiciels (ex. [catalogue des logiciels du MédiaLab de SciencesPo](https://medialab.sciencespo.fr/outils/)). 

Par exemple, en tapant «&nbsp;Linux source code&nbsp;» dans un moteur de recherche, vous tomberez assez rapidement sur une page intitulée «&nbsp;GitHub - torvalds/linux: Linux kernel source tree&nbsp;» à l’adresse <https://github.com/torvalds/linux>. Cette adresse est celle de l’«&nbsp;origine&nbsp;», c’est-à-dire du dépôt distant de référence. Elle permet de retrouver très facilement le code source sur Software Heritage (comme vous le verrez dans le point 4 ci-dessous).
  • §56 : ajouter une virgule après le 2e tiret d’incise : fichiers —, obtenir

  • §63 : hyperliens seulement sur package R {tm} et sur fichier src/scan.c

  • §66 : pourpermettrepour permettre

  • §75 : préciser le nom de l’extension ?

    • Notons qu’une extension de navigateur, [UpdateSWH](https://www.softwareheritage.org/browser-extensions/), disponible
  • §76 : la fig. 5 n’apparaît pas. Un problème de lien peut-être ?

  • §90 : supprimer le lien actuel sur README et ajouter une note plutôt (ou une précision entre parenthèses)

  • §93 : Les métadonnées intrinsèques : elles fournissentLes métadonnées intrinsèques fournissent

  • §94 : remplacer le point d’interrogation par un point.

  • §94 : supprimer l’hyperlien sur catalogues qui renvoie à un exemple précis. Pour évoquer cet exemple, préférer une précision entre parathèse ou une note.

  • §104 : supprimer les : après Exercice

  • §107 : supprimer le 2e Exercice et commencer le nouveau paragraphe par Pour terminer

  • §109 : proposer une conclusion plutôt qu’un résumé ?
    [name=sabrina] @frederic-santos @BapMel : svp, avant le 22/07, pourriez-vous jeter un oeil à cette proposition, volontairement pas insérée dans le texte? https://hedgedoc.softwareheritage.org/conclusion-PH#

  • §111 : fusionner les deux premières puces

    • Pour toute demande relative à Software Heritage, consulter la foire aux questions ou utiliser le formulaire de contact.
  • §111 : reformuler la dernière puce

    • Pour suivre l’actualité de Software Heritage, consulter le blog dédié ou inscrivez-vous à sa newsletter

Hyperliens

  • En règle générale : privilégier les notes pour les précisions et les exemples, et les hyperliens pour les liens directs à un objet cité (exemple, ressource, outil...)
    • Ex. §90
  • Réduire la taille des hyperliens (sur 2/3 mots max)
    • Ex. § 22 : hyperlien sur documentation uniquement
    • Ex. § 44 : hyperlien sur documentation technique uniquement (ou sur types de SWIDS disponibles éventuellement)
    • Ex. §94 : hyperlien sur formulaire de saisie uniquement
  • Le lien du paragraphe 2 ne semble pas fonctionner.

En règle générale, corrections typographiques

  • Supprimer les virgules superflues devant les conjonctions de coordinations (surtout : mais, ou, et)
    • , etet | , ouou
    • Ex. §22 `sans créer de compte et il n’est pas nécessaire
  • Mettre des apostrophes françaises partout :
  • Mettre des guillemets français : « et »
  • Dans les listes
    • Mettre des majuscules à chaque ligne
    • Mettre des points ou des points-virgules à la fin de chaque ligne (surtout s’il s’agit de phrases complètes)
    • Ex. § 31, §32
  • Unifier : par exemple ou ex. (mais pas les deux)
  • Pour les légendes des figures, remplacer les : par un point
    • Figure 1 : TousFigure 1. Tous

Suite à cette première relecture, vous avez environ un mois pour intégrer les corrections proposées, donc disons idéalement jusqu’au lundi 22 juillet ?
Pendant ce temps je vais rechercher les deux expert(e)s qui évalueront votre leçon lorsque celle-ci aura été modifiée.

Bon courage et n’hésitez pas demander des précisions sur ce ticket si besoin !

@marie-flesch
Copy link
Contributor Author

Merci @DMathelier pour cette première relecture ! @frederic-santos, @BapMel et @sabrinagranger , en fait pas besoin de vous occuper des apostrophes et des guillemets, on va le faire nous-mêmes :) Pour les autres propositions, nous vous laissons appliquer celles qui vous semblent pertinentes.

@frederic-santos
Copy link
Collaborator

Bonjour Marie @marie-flesch et Daphné @DMathelier,

Nom d'un pingouin, quelle efficacité ! Merci beaucoup pour cette relecture attentive et ces corrections !
Je viens de pousser quelques commits qui en implémentent déjà une bonne partie ; nous allons discuter avec mes co-auteurs pour corriger le reste dans la quinzaine à venir.

J'ai juste deux remarques/questions techniques de mon côté :

Le lien du paragraphe 2 ne semble pas fonctionner.

Théoriquement, il fonctionnera sur le site "réel" de PH (je pense ?). C'est un lien relatif vers une autre leçon hébergée sur PH, et je crois justement que les instructions aux auteurs recommandaient de donner un lien relatif plutôt qu'un lien absolu si vous voulait faire référence à une autre leçon. Est-ce toujours le cas ?

§76 : la fig. 5 n’apparaît pas. Un problème de lien peut-être ?

Oui, c'est lié à la remarque faite par Charlotte plus haut. Nous avons fait une boulette dans la version initiale de l'article, en insérant pour la Figure 5 un lien vers un fichier citar_GitHub.png, alors que le PNG que nous avons transmis s'appelait en réalité citar_GitHub_raw.png. J'ai tenté de corriger ça de mon côté, mais visiblement, pas de la bonne manière. 😀

Merci en tout cas, nous vous préviendrons quand tout sera corrigé !

@charlottejmc
Copy link
Collaborator

charlottejmc commented Jun 20, 2024

Bonjour @frederic-santos et @DMathelier,

En effet, j'attendais juste une confirmation avant d'insérer le bon lien vers la Figure 5. C'est donc bon maintenant, merci !

Je me chargerai en Phase 6 des corrections typographiques (guillemets, apostrophes, etc.). Ceci fait partie du travail que faisons @anisa-hawes et moi pendant la phase de "typesetting", et qui assure l'uniformité visuelle de nos leçons à travers les quatre langues. Ne vous inquiétez donc pas trop pour la forme !

Un certain nombre de points relevés par @DMathelier sont en fait dûs à des changements que j'ai faits moi-même en créant le fichier ! Par exemple, la forme des listes – dans nos consignes, nous demandons à ce qu'on n'utilise pas de ponctuation (points virgules, point final) à la fin de chaque ligne. Je les ai donc retirés du texte original soumis par les auteurs.

Merci ✨

@anisa-hawes
Copy link
Contributor

Bonjour Sabrina @sabrinagranger, Baptiste @BapMel, and Frédéric @frederic-santos,

What's happening now?

Your lesson has been moved to the next phase of our workflow which is Phase 3: Revision 1.

This phase is an opportunity for you to revise your draft in response to @DMathelier's initial feedback. As @marie-flesch explains, @charlottejmc and I take care of all typographical adjustments as part of Phase 6 Sustainability + Accessibility. This ensures that all lessons are presented consistently across our four journals. Thank you for your understanding ☺️

I've checked to ensure that you have the 'write access' you'll need to edit your draft directly. (Baptiste @BapMel, I have sent you an invitation to join us as an Outside Collaborator, but I note that it is still pending. Please let me know if you have any difficulties gaining access.)

We ask authors to work on their own files with direct commits: we prefer you don't fork our repo, or use the Pull Request system to edit in ph-submissions. You can make direct commits to your file here: /fr/en-cours/originales/preserver-logiciels-recherche.md. @charlottejmc and I can help if you encounter any practical problems!

When you and Daphné are all happy with the revised draft, we will move forward to Phase 4: Open Peer Review.

%%{init: { 'logLevel': 'debug', 'theme': 'dark', 'themeVariables': {
              'cScale0': '#444444', 'cScaleLabel0': '#ffffff',
              'cScale1': '#3d7c81', 'cScaleLabel1': '#ffffff',
              'cScale2': '#444444', 'cScaleLabel2': '#ffffff'
       } } }%%
timeline
Section Phase 2 <br> Initial Edit
Who worked on this? : Editor (@DMathelier) 
All  Phase 2 tasks completed? : Yes
Section Phase 3 <br> Revision 1
Who's working on this? : Authors (@sabrinagranger, @BapMel, @frederic-santos)  
Expected completion date? : July 22
Section Phase 4 <br> Open Peer Review
Who's responsible? : Reviewers (TBC) 
Expected timeframe? : ~60 days after request is accepted
Loading

Note: The Mermaid diagram above may not render on GitHub mobile. Please check in via desktop when you have a moment.

@anisa-hawes anisa-hawes moved this from 2 Initial Edit to 3 Revision 1 in Active Lessons Jun 20, 2024
@sabrinagranger
Copy link
Collaborator

@frederic-santos : mille mercis pour les modifications apportées! j'ai refait un tour (notamment pour modifier le tableau (§45 : agencement du tableau à revoir) comme demandé mais j'ai reçu des messages d'erreur. Stp, pourrais-tu vérifier si tout est ok?

@anisa-hawes
Copy link
Contributor

Bonjour Sabrina @sabrinagranger,

I hope you're well. Thank you for your work on these revisions!

In your note above, you mention receiving error messages. Do you mean an error when you are making a commit to the ph-submissions repository?

I just wanted to clarify that when we make several commits in quick succession, our previous build-checks are automatically cancelled (then show with a red cross). But this doesn't mean that there has been a problem with your commit, and indeed we can be confident that everything is well in this case because your subsequent and most recent commits have been successful.

@charlottejmc and I are here to help with any practical questions about working with Markdown or the particulars of our repository. Please let us know if we can lend a hand! ☺️

@sabrinagranger
Copy link
Collaborator

sabrinagranger commented Jul 10, 2024

Hello @anisa-hawes!
Thanks for your super fast support. :)
Here is what I got:
image

@sabrinagranger
Copy link
Collaborator

I received these notifications after my commits

@frederic-santos
Copy link
Collaborator

Bonjour @charlottejmc,
Merci pour ces propositions ! Tout me va également, donc de me range à l'avis de Sabrina et vote pour le mécanisme d'horloge.
Je suis néanmoins incroyablement flatté par ces propositions de gravures de Grand Pingouin, qui me permettent de commencer ma semaine dans la joie la plus totale 😎

@charlottejmc
Copy link
Collaborator

Merci pour vos retours @frederic-santos et @sabrinagranger – j'ai donc préparé l'image du mécanisme d'horloge ⏲️

@charlottejmc
Copy link
Collaborator

charlottejmc commented Nov 13, 2024

Hello Sabrina @sabrinagranger, Baptiste @BapMel, and Frédéric @frederic-santos,

Il nous reste encore quelques petites choses à rassembler avant de pouvoir publier la leçon :

  • Provide a short abstract: for the lesson
  • Provide author(s) bio for ph_authors.yml using this template:
- name: Forename Surname
  orcid: 0000-0000-0000-0000
  team: false
  bio:
    fr: |
      Forename Surname est professeur assistant au département des matières à l'université de City.

Merci ! 🐧

@sabrinagranger
Copy link
Collaborator

sabrinagranger commented Nov 13, 2024

Bonjour @charlottejmc !
Entendu, merci.
Voici la bio:

  • name: Sabrina Granger
    orcid: 0000-0002-9081-3851
    team: false
    bio:
    fr: |
    Sabrina Granger est open science community manager au sein de Software Heritage, une infrastructure dédiée à la préservation et au partage de code source.

2024-11-14: update = replace SWH by false

@frederic-santos : je te fais une proposition de résumé que tu pourras modifier, ça te va?
🐹

@marie-flesch
Copy link
Contributor Author

Merci pour l'image @charlottejmc, c'est top ! Je vais préparer les tweets pour faire la communication de la leçon :) @sabrinagranger , @frederic-santos et @BapMel , êtes-vous sur X/Twitter, et si oui/si vous voulez, pourriez-vous me transmettre vos noms d'utilisateurs pour que je les mette dans les tweets ?

@sabrinagranger
Copy link
Collaborator

sabrinagranger commented Nov 13, 2024

Bonjour @marie-flesch !

merci beaucoup pour tout cela ; côté Software Heritage, on s'appuiera sur votre communication pour diffuser dans nos canaux également.
Svp, serait-il possible de mentionner: SwHeritage (X) et swheritage (Mastodon)?

Pas de nom utilisateur à vous transmettre me concernant, je n'ai pas de compte X. 🦕

@frederic-santos
Copy link
Collaborator

Bonjour tout le monde,

Voici pour ma bio :

name: Frédéric Santos
orcid: 0000-0003-1445-3871
team: false
bio:
  fr: |
    Frédéric Santos est ingénieur d'études en statistique au laboratoire PACEA (De la Préhistoire à l'Actuel : Culture, Environnement, Anthropologie), situé à Bordeaux.

(Je ne suis pas trop sûr du tag team, mais s'il est censé donner l'employeur, alors ce devrait être team: CNRS).

Pas de compte X pour moi non plus !

Enfin, voici un résumé proposé par Sabrina (merci !) :

abstract: Cette leçon présente des modalités d'archivage adaptées aux spécificités du logiciel et à différents profils d'utilisateurs. Elle recommande l'utilisation d'un identifiant permettant de référencer les différents composants d'un logiciel. Les bonnes pratiques pour citer les logiciels, ainsi que des méthodes pour explorer efficacement les fonds de Software Heritage, seront abordées. Ces pratiques peuvent facilement et progressivement s'intégrer dans un workflow de recherche ouverte, que l'on développe ou non du code source. Le but de ce guide est de fournir de premiers repères pour s'orienter dans un contexte qui évolue rapidement.

Encore merci à tous !

@sabrinagranger
Copy link
Collaborator

sabrinagranger commented Nov 13, 2024

Pas de compte X pour moi non plus !

@frederic-santos 😅 heureusement qu'on n'envisageait pas de se reconvertir en influenceurs "préservation de logiciels"
@BapMel : tout repose sur toi Baptiste 🤞

@BapMel
Copy link

BapMel commented Nov 14, 2024 via email

@charlottejmc
Copy link
Collaborator

Entendu @BapMel, merci – tant que vous êtes là, pourriez-vous aussi nous faire parvenir une courte bio dans ce format :

- name: Forename Surname
  orcid: 0000-0000-0000-0000
  team: false
  bio:
    fr: |
      Forename Surname est professeur assistant au département des matières à l'université de City.

Merci et bon courage avec vos copies !

@sabrinagranger
Copy link
Collaborator

sabrinagranger commented Nov 14, 2024

@BapMel : comme j'ai des infos dans mes tiroirs, peux-tu me dire si cette proposition de bio t'irait stp?

  • name: Baptiste Mélès
    orcid: 0000-0002-5692-083X
    team: false
    bio:
    fr: |
    Baptiste Mélès est chercheur aux Archives Henri-Poincaré - Philosophie et Recherches sur les Sciences et les Technologies (AHP-PReST). Il a fondé le séminaire “Codes sources”.

update = replace CNRS by false

@sabrinagranger
Copy link
Collaborator

Je n'ai pas de compte Twitter.

C'est donc carton plein pour notre équipe !

@frederic-santos et @BapMel : pensez-vous qu'on serait crédibles aux yeux de @marie-flesch si on lui dit qu'on est tous sur TikTok??

  • réponse A: Tout à fait
  • réponse B: Tu nous as bien vus?
  • réponse C: Peut-être par temps de brouillard

@anisa-hawes
Copy link
Contributor

anisa-hawes commented Nov 14, 2024

Merci à vous tous!

Baptise @BapMel, I await confirmation that you're happy with the bio Sabrina has suggested for you?

To clarify that the field team: corresponds to membership of our internal PH Project Team, so in each of your cases this line will read team: false (and this won't display on the lesson - it is simply part of our site metadata).

In the meantime, Marie @marie-flesch and I will prepare for publication. We are very excited about publishing a new original lesson in Programming Historian en français!

@anisa-hawes
Copy link
Contributor

Bonjour Sabrina @sabrinagranger, Baptiste @BapMel, and Frédéric @frederic-santos,

Preparing the files for publication, I am encountering some errors with the following pages of the Software Heritage website:

Each of these returns a 404 error. Could you help us to identify the alternative links? (Has the website structure changed recently? Might anything else in the lesson need to be updated to reflect these changes?)

With many thanks for your collaboration.

@frederic-santos
Copy link
Collaborator

Hi @anisa-hawes!

Oh, I see -- paragraph 60, I guess.
Actually, this is the expected outcome, but maybe we didn't use the appropriate (Markdown) syntax. They are supposed to be only prefixes for URLs, and not whole URLs. So, they don't work, but everything's fine because they are not supposed to work 😄
Maybe we should have written this list like that:

Vous pouvez alors explorer la page correspondante en rajoutant l’un des préfixes suivants, selon le type de ressource :

  • Pour un fichier : https://archive.softwareheritage.org/browse/content/
  • Pour un répertoire : https://archive.softwareheritage.org/browse/directory/
  • Pour une capture : https://archive.softwareheritage.org/browse/snapshot/
  • Pour une version : https://archive.softwareheritage.org/browse/release/
  • Pour une révision : https://archive.softwareheritage.org/browse/revision/

(i.e., putting those prefixes between backquotes)

@anisa-hawes
Copy link
Contributor

Thank you, Frédéric @frederic-santos!
This makes sense - I've made that adjustment ☺️

@marie-flesch
Copy link
Contributor Author

Super, on y est presque ! Votre discussion sur X / TikTok m'a fait bien rire @sabrinagranger, @frederic-santos et @BapMel 😅 ! Et je découvre que nous sommes "voisins" Baptiste (je travaille à Paris mais j'habite à Nancy)

@BapMel
Copy link

BapMel commented Nov 14, 2024 via email

@BapMel
Copy link

BapMel commented Nov 14, 2024 via email

@anisa-hawes
Copy link
Contributor

Merci, Baptiste @BapMel

@sabrinagranger
Copy link
Collaborator

sabrinagranger commented Nov 15, 2024 via email

@marie-flesch
Copy link
Contributor Author

Bonjour @sabrinagranger . Nous sommes en train de préparer la publication, ce qui implique de faire d'ultimes vérifications. A priori, la leçon sera publiée mercredi, et l'information diffusée dans la foulée sur le compte X de Programming Historian. Je demanderai aux membres de l'équipe francophone de diffuser l'info sur leurs canaux perso (X, LinkedIn, etc.) et je le ferai aussi de mon côté. Sentez-vous libre de communiquer où vous voulez pour faire de la pub à cette belle leçon, une fois publiée ; je vous avertirai ici de la publication :)

@sabrinagranger
Copy link
Collaborator

sabrinagranger commented Nov 15, 2024 via email

@charlottejmc
Copy link
Collaborator

Bonjour @sabrinagranger, nous diffuserons aussi l'annonce sur le compte Mastodon de Programming Historian.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: 7 Publication
Development

No branches or pull requests

10 participants