owned this note
owned this note
Published
Linked with GitHub
Sprint HAL-SWH-IES: activités 2020
==================================
###### tags: `sprint` `sofwtare preservation` `HAL` `CCSD` `SWH`
:::info
- **Lieu** https://8x8.vc/softwareheritage/8x8
- **Quand** 28 avril 2020 de 10h a 12h
- **Agenda précédent**
Jour 1:
10.00 - Objectif du sprint
10.45 - Formats exports:TEI, CodeMeta, CFF
12.30 - Déjeuner
14.00 - Bibtex
- retour Raweb
- retour GT citation
- retour communauté Software Citation Implementation WG
- implémentation dans HAL
15.30 - Pause
15.45 - Taxomnomy des contributeurs
17.00 - fin de journée
Jour 2:
10.00 - Réflexion collective - Spécification d'un dépôt sur HAL à partir d'un SWH-ID ou d'un repository (avec Save Code Now)
11.00 - Définir feuille de route pour implémentation
12.30 - Déjeuner
14.00 - Améliorer la visibilité du logiciel.
- Visible comme Findable dans FAIR :
- registry / catalogue
- text mining pour retrouver des mentions de logiciel
- findable on SWH (search deposit metadata on web-app)
- Grobid (http://cloud.science-miner.com/software/)
- SwMath, ASCL, OpenAire, Zenodo,
- Linked Open Data - Research graph
- Lié les articles, les données et les logiciels
15.15 - Conclusion Sprint et les étapes suivantes (Sprint en Octobre / Novembre ?)
16.00 Fin de journée
- **Participants:**
- CCSD :
- Bruno Marmol ;
- Yannick Barborini [@Z6Qtb7PYR72sgQUI1qU0MA]
- Software Heritage :
- Roberto Di Cosmo ;
- Morane Gruenpeter [@2uPp2KwgQQaoq8fcQr2VfQ] ;
- Antoine R. Dumont?
- Valentin ?
- Inria :
- Jozéfina Sadowska [@jhgqBP2VSHmoR50jOiYr5g] ;
- Estelle Nivault ;
- Alain Monteil [@ts8AtqtpTyCdUU6ISEsBKQ] ;
- expert RDF Olivier Corby ?
- **Reference:** - [Le pad de préparation](https://pad.inria.fr/p/np_wW66biYwXaVwivxQ)
:::
[TOC]
:dart: Objectif du sprint:
---
1. Finalisation du dépôt logiciel actuel avec:
- les format d'export HAL (Citation, TEI, Bibtex, endnote, DC, DCterms)
- et les nouveaus exports (CodeMeta, CFF)
2. Initialisation et spécification d'un dépôt sur HAL à partir d'un SWHID ou d'un repository
3. Intégration des logiciels dans hal data
:books: Sprint Bibliography
---
- Bibtex @software entries:
- Stable proposal approved by Inria Citation WG https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-entry/-/blob/master/swentry.org
- Biblatex implementation on CTAN https://www.ctan.org/tex-archive/macros/latex/contrib/biblatex-contrib/biblatex-software
- Exemple sur un article
https://gitlab.inria.fr/dicosmo/ocamlp3l-rescience/-/blob/master/article.pdf
- Pierre Alliez, Roberto Di Cosmo, Benjamin Guedj, Alain Girault, Mohand-Said Hacid, Arnaud Legrand, Nicolas Rougier. Attributing and Referencing (Research) Software: Best Practices and Outlook From Inria. Computing in Science Engineering, 22 (1), pp. 39-52, 2020, ISSN: 1558-366X. https://dx.doi.org/10.1109/MCSE.2019.2949413 also available https://hal.archives-ouvertes.fr/hal-02135891
- Roberto Di Cosmo, Morane Gruenpeter, Stefano Zacchiroli. Referencing Source Code Artifacts: a Separate Concern in Software Citation. Computing in Science & Engineering, 2020, ISSN:1521-9615. https://dx.doi.org/10.1109/MCSE.2019.2963148 also available on https://arxiv.org/abs/2001.08647
- Di Cosmo, Roberto; Gruenpeter, Morane; Marmol, Bruno; Monteil, Alain; Romary, Laurent; Sadowska, Jozefina. Curated Archiving of Research Software Artifacts: lessons learned from the French open archive (HAL) Slides from IDCC 2020 presentation at https://doi.org/10.5281/zenodo.3667713, full article https://hal.archives-ouvertes.fr/hal-02475835.
:mag: Sprint Retro
---
### Comment organiser l'avancement sur le sprint logiciel à distance?
- faire le sprint ou une partie du sprint à distance avec des appels mensuels
- maintenir des appels hebdomadaires ou mensuels sur les sujets du sprint
- mettre à jour les tâches du sprint
:closed_book: Tâches
--
==responsable== / tâche / **priorité** (plus important 1- 10 moins important)
Il est recommandé d'ouvrir des tâches dans les outils appropriés:
- pour le CCSD avec des tickets sur https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues
- pour SWH sur https://forge.softwareheritage.org/
### 1. Interface utilisateur
#### 1.1 Le Formulaire
- [ ] Ajouter les métadonnées suivantes sur le formulaire pour les logiciels:
- [x] institution (comme pour rapport) - OK
- [X] publisher - **NOK** <ref type="publisher">https://wacai2020.sciencesconf.org/</ref>- URL conférence ou éditeur
- [X] referencePublication (voir https://forge.softwareheritage.org/T1732), multivalue avec controle sur "des" types d'identifiants --> OK ? <biblStruct><relatedItem target="https://inria.halpreprod.archives-ouvertes.fr/hal-01876705" type="isReferencedBy">Test relation dépôts</relatedItem>
</biblStruct>
Publications associées / Associated publications
- [ ] Ajouter les nouvelles métadonnées aux exports et au transfert chez SWH
- [x] (==YB== dispo en preprod. Valider les traductions)Ajouter les nouveaux rôles d'auteurs
- voir https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/249
- [x] ==CCSD== recupérer SWHID avec contexte depuis SWH, et affichage du SWHID complet
- voir https://forge.softwareheritage.org/T2366
- [x] ==YB== écrire les questions sur l'ajout des métadonnées au formulaire: https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/268
##### 1.1.1 Les rôles
- [ ] ==CCSD== voir comment ajouter des roles multiples quand un
- [x] [Preprod] [#249](https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/249)
- [x] ==YB== supprimer crp - auteur correspondant
- [ ] ==YB==: supprimer contributeur (attendre le retour des 11 dépôts jusqu'au 22 Juin) ?
- [ ] voir comment faire avec les 11 dépôts avec contributeur qui ont renseigné cette métadonnée ?
#### 1.2 la notice
- [ ] ==CCSD== ajouter commentaire et lien vers le paquet BibLaTeX sur CTAN depuis le cadrant "citation"
- [X] ==CCSD== modifier recupération du SWHID avec context et de l'affichage du SWHID [#264](https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/264)
### 2. Formats exports: Citation, TEI, Bibtex, endnote, DC, DCterms, CodeMeta, CFF
#### 2.1 TEI:
- [ ] ==IES/ EN JS AM== Recenser les modifications à faire sur les formats existants: **1**
- [ ] TEI voir specif => https://docs.google.com/spreadsheets/d/1L5lIB_S8U9DnkHZMriEPX4XpwqGCkDe6eLncM8qWRJk/edit?ts=5e70ca09#gid=415198605
- [ ] Revoir le format mis à jour sur pre-prod **1**
- [x] erreurs/modifications TEI ()
- [x] (==YB==) Les logiciels sous embargo sont exposée à partir du TEI/bibtex avec la propriété FILE **1**
- voir https://gitlab.ccsd.cnrs.fr/ccsd/hal/issues/183
- [x] (==YB== dispo en preprod) remplacer 'platform' en 'operatingSystem'
- voir https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/245
- [x] (==YB== dispo en preprod) ajouter 'developmentStatus ' (Note: Pas encore intégré à l'export)
- voir https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/246
- [x] (==YB== dispo en preprod) ajouter 'runtimePlatform' (Note: Pas encore intégré à l'export)
- voir https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/247
- [x] (==YB== dispo en preprod) changer le codage en 3 lettres au profit du litéral complet 'dev' en 'developer'
- voir https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/248
- [ ] IES-INRIA: valider TEI dans la pre-prod.
#### 2.2 Citation:
- [ ] ==IES-SWH/ JS EN MG==Citation intégrer les champs ? exemple publisher ou institution ? **1**
#### 2.3 BibTeX:
- [ ] Bibtex (sur la base de la proposition du GT Citation pilote par Roberto et Alain Girault)
- [ ] ==?== reviser la feuille de style de génération du bibtex /!\ après la finalisation de la TEI **1**
- [x] ==Roberto== Finaliser software bibitems
- [x] ==JS== BibTeX fournir à Bruno le travail de Guillemette + voir la mise à jour de la feuille de style
#### 2.4 CodeMeta:
- [ ] ==MG== Créer correspondance sur la table CodeMeta [proposition sur CodeMeta->HAL PR](https://docs.google.com/spreadsheets/d/1w3NzzHuR8KNgYlGiLJH0FSc5eXxV9t3xcw9mKPXfK7k/edit?usp=sharing) **1**
- [ ] faire un PR sur CodeMeta **1**
- [ ] ==MG== vérifier les termes manquants (sur SWORD) et signaler au CCSD **1**
- [ ] downloadUrl -> file
- [x] ==MG== préparer un exemple json-ld CodeMeta pour implémentation par le CCSD (export codemeta.json) **2** (https://hackmd.io/@HAL-SWH-IES/ByMc9kicL/edit)
- [X] ==YB== export codemeta.json sur HAL (https://hal.halpreprod.archives-ouvertes.fr/hal-02071874v1/codemeta)
- [x] ==MG== commenter l'export codemeta.json et créer une tâche (https://forge.softwareheritage.org/T2527)
#### 2.5 Autres formats:
- [ ] endnote trouver une personne experte en endnote !**8**
- [ ] DC **8**
- [ ] DCterms **8**
- [ ] ==AM MG== Créer une correspondance HAL -> Citation File Format (CFF) ou décider qu'une application de la correspondance HAL -> CodeMeta -> CFF est correcte **8** voir partie SWH
- [ ] export citation.cff - voir l'utilité d'un citation.cff par rapport à une sortie bibtex
### 3. Dépôt métadonnées avec SWHID
#### 3.1 spécifications
- [ ] ==CCSD== vérifier limitation du dépôt des métadonnées avec modération **3**
~~- [ ] ==CCSD== vérifier les spécifications du dépôt des métadonnées d'un logiciel sur SWH **6**~~
- [x] ==MG== écrire cas d'utilisation et scénario de la modification de métadonnées d'un dépôt existant sur HAL **2** (https://hackmd.io/@HAL-SWH-IES/BkzfYx2MD)
- [x] ==MG== écrire spécifications d'un nouveau dépôt de métadonnées avec un SWH-ID **5**
- [ ] ==MG== écrire spécifications d'une deuxième version d'un dépôt existant en utilisant le SWHID **5**
- [ ] ==IES-Inria== valider et répondre aux interrogation sur les spécification du dépôt métadonnés: https://hackmd.io/@HAL-SWH-IES/BkzfYx2MD
- [x] ==SWH== décider si on veut modifier le format d'envoi des métadonnées en ayant une balise <codemeta> </codemeta> dans laquelle nous recevons l'export codemeta de HAL tel quel
- [x] ==MG== revoir le dépôt des métadonnées en SWORD côté SWH si un codemeta.json chez HAL est implémenter
- voir https://forge.softwareheritage.org/T2311
- [X] ==MG== écrire specs ou revoir specs côté SWH **3**
- voir https://forge.softwareheritage.org/T960 et https://forge.softwareheritage.org/T2312
##### 3.1.1 spécifications spécial forge Inria
- [ ] ==MG + IES INRIA== détailler les scénarios de dépôt et de modération
#### 3.2 validation
- [ ] ==CCSD / IES INRIA /SWH== scénario modifier métadonnées
- [ ] ==CCSD / IES INRIA /SWH== scénario déposer métadonnées sur SWHID
- [ ] ==CCSD / IES INRIA /SWH== scénario nouvelle version sur nouveau SWHID (même HAL-ID)
#### 3.3 implementation
- [X] ==SWH== implémenter dépôt de métadonnées sur un objet SWH **5**
- voir https://forge.softwareheritage.org/T1021
- [ ] ==CCSD== impléménter dépôts métadonnées avec modération **5**
- [ ] ==CCSD== implémenter dépôt de métadonnées pour la mise à jour des métadonnées d'un dépôt HAL **5**
- preparation pour depots logiciels a partir d'un SWHID
- [ ] lire un codemeta.json sur SWH pour pre-remplir le formulaire de depot
- [ ] renvoyer a Software Heritage via SWORD les metadonnees validees/modifiees sans le .tar.gz
### 4. Software collection et module
- [x] ==IES/SWH==faire une collection test sur la preprod avec le dépôts suivants:
* https://inria.halpreprod.archives-ouvertes.fr/view/index/docid/2510118 hal-02510118
* https://inria.halpreprod.archives-ouvertes.fr/view/index/docid/2510117 hal-02510117
- [ ] ==IES Inria== fiche collection: spécification comment créer une collection
- [ ] ==CCSD== Réflexion globale pour faire évoluer les métadonnées pour les relations
- [ ] **Conclusion**: Ajouter une métadonné `isModule` ou `estModule`
### 5. Documentation
- [ ] ==IES-INRIA + MG== mettre à jour guide de modération et de dépôt **10**
- [ ] Organisme/institution voir la documentation d'accompagnement + tous les nouveaux champs
- [x] ==Roberto== Publisher préciser dans la doc Biblatex qu'il s'agit de l'autorité qui qualifie le logiciel
- [ ] ==IES/SWH== Mise à jour du guide : rôles + tous les champs ~~(seulement après l'implementation)~~
[ ] ACTION: Clarifier la spec/documentation de BibLaTeX sur l'utilisation de la propriété `title` dans un `@softwaremodule`
- [ ] == ? == ajouter commentaire et lien vers le paquet BibLaTeX sur CTAN sur la documentation CCSD
### 6. Communication
#### 6.1 Export BibTeX
- [x] ==EN AM== Episciences proproser aux revues le travail de biblatex fait par le groupe de Roberto
- [x] ==RD== fournir texte pour "breve" Inria sur les nouveaux formats latex disponibles
- [ ] ==GT citation== breves A valider en GT et faire une version anglaise
#### 6.2 Fermeture de la forge Inria
- [ ] écrire communication par paliers
- [ ] forge Inria va être archiver sur SWH (code et mailing list)
- [ ] vous pouvez déposer dans HAL (comme avant zip et métadonnées): clarifier que cela n'est pas adapté à l'archivage de l'historique
- [ ] dépôt avec SWHID sur HAL
### 7. Misc
#### 7.1 Raweb
- [ ] ==JS== A modifier sur Raweb(**):
- [ ] Licence` changer en `License`
- [ ] modifier l'export du contenu de `note` avec le contenu de la métadonnée `commentaire`
## Notes
## Réunion 28.4.2020
**Participants**
Jozefina
Estelle
Morane
Bruno
Roberto
Alain
Yannick
**Objectif de la réunion:**
- voir où on en est et comment planifier le travail.
**Ce qui est déjà fait:**
### Export BibTeX
- proposition GT citation Inria sur CTAN
- @sofwtare, @softwareversion, @softwaremodule, @codefragment
- période de modération?review? utilisable de suite (le résultat du travail des chercheurs)
- diffusion à l'international (Roberto et Morane)
- rapport d'activité avec RAWEB (export HAL) nouvelle version fin
- dépôt sur ArXiv.bbl?
- pas de problème
- implementation de l'export BibTex sur HALD
- export BibTeX sur DBLP: export compact et export étendu
- sur HAL l'export est toujours le même, l'export avec et sans la version ça risque d'être compliqué
- nous n'avons pas la notion de module (avec le lien crossref)
- n citation (sur le nombre de version) est ce qu'on veut avoir la citation non versionée?
- dès le moment où on a le module.... [à completer]
- un document = un export BibTex
- exemple DBLP avec l'export `standard`, `condensed`, `with crossref` -> une question de présentation
- nous n'avons pas la notion de module dans HAL actuellement
- héritage des métadonnées d'un niveau supérieur pour ne pas devoir le refaire pour chaque module
- la liason entre documents se fait après le dépôt des deux documents
- Part Of d'une version d'un document
- Héritage au moment du dépôt?
- Si le père change, est ce que les fils changent aussi?
- Il n'y a pas une resaisie des métadonnées
- l'objet supérieur (@sofwtare) doit être déposé sur HAL avant les modules avec la rélation (isPartOf qui existe déjà)
- dans l'interface la demande de lien quand le document est déjà présent
- Est ce qu'en mettant une propriété isPartOf crée un module automatiquement?
- ajouter champs type module
- que faire si le @software n'est pas dans HAL?
- Est ce qu'on a une sous typologie
- labellisation du module avec le label du logiciel (comme CGAL)
### Finaliser formulaire sur HAL
- ajouter `institution` [`institution` en EN] et `editeur` [`publisher` en EN] comme métadonnées à saisir (ouvrir tickets CCSD)
- credit, légitimité au logiciel
- plan national sur la recherche sur l'IA
- Roberto: modifier le BibTeX pour avoir plusieurs intitutions
- ajouter des exemples sur les propriétés
- pas de distinction entre institution et organization
- le champs `referencePublication` (relation entre document) illustrer par (un détail de présentation)
- 1 article ou plusieurs?
- sur SwMath il y a un exemple avec 4 `standard article` (referencePublication sur SwMath).
- lien vers HAL ou pas?
- qu'est ce qu'on accepte?
- accepter seulement des identifiants qualifiés (HAL-ID, DOI, ArXiv ID, URL?)
- une référence de l'article vers le logiciel
- inverser la relation
- roles:
- Nouveaux: [traduction en FR des rôles]
- Design (algorithm) ergonomist ? [?? concepteur d'interface/ergonome = spécialiste UX pourquoi algorithm ? ]
- Architecture architect ? [architecte]
- Debugging Debugger ? [débogueur? d'après wikipédia c'est un logiciel]
- Maintenance [garder Mainteneur]
- Coding developer ? [garder Développeur]
- Documentation technical Writer ? [rédacteur technique]
- Testing [testeur-se]
- Support [support]
- Management [chef-fe de projet ? superviseur ? manager ?]
- Ancien: actuel
- Développeur
- Contributeur
- Mainteneur
- Auteur correspondant
- Sur la TEI en 3 lettres
- Plusieurs roles?
- actuellement pas possible
- pour l'instant CCSD vérifie la possibilité d'ajouter plusieurs rôles
---
### Actions & tâches
En petit groupes
- CCSD
- [ ] TEI
- [ ] voir comment ajouter des roles multiples
- tickets ouverts:
- [X] [Preprod] [#245](https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/245)
- [X] [Preprod] [#246](https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/246)
- [x] [Preprod] [#247](https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/247)
- [x] [Preprod] [#248](https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/248)
- [x] [Preprod] [#249](https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/249)
- preparation pour depots logiciels a partir d'un SWHID
- [ ] lire un codemeta.json sur SWH pour pre-remplir le formulaire de depot
- [ ] renvoyer a Software Heritage via SWORD les metadonnees validees/modifiees sans le .tar.gz
- IES-INRIA
- [x] BibTeX fournir à Bruno le travail de Guillemette + voir la mise à jour de la feuille de style
- [ ] Organisme/institution voir la documentation d'accompagnement + tous les nouveaux champs
- [x] Publisher préciser dans la doc Biblatex qu'il s'agit de l'autorité qui qualifie le logiciel
- [ ] Mise à jour du guide : rôles + tous les champs (seulement après l'implementation)
- [x] Episciences proproser aux revues le travail de biblatex fait par le groupe de Roberto
- Alain & Morane
- [x] export codemeta.json (https://hackmd.io/@HAL-SWH-IES/ByMc9kicL/edit)
- [ ] export citation.cff
- [ ] voir l'utilité d'un citation.cff par rapport à une sortie bibtex
- Roberto
- [x] ==RD== fournir texte pour "breve" Inria
**Prochaine réunion:**
- [x] doodle: Alain propose un evento pour une prochaine réunion d'ici 3 à 4 semaines
- [ ] ==GT citation== breves A valider en GT et faire une version anglaise
- [x] Valider les rôles
- [x] questions bibtex
## Réunion 25.5.2020
**Participants**
### Objectifs
1. Valider les rôles
2. Évaluer les modifications nécessaires pour l'ajout de l'objet module
3. Export BibLaTex/BibTex
4. Avancement sur modifications/ajouts des métadonnées et vers un export CodeMeta
5. SWHID et discussion préliminaire sur un dépôt de notice pour un contenu archiver sur SWH utilisant un SWHID
### Agenda + Notes
#### rôles
1. Les fonctions suivantes sont difficilement traductible :
`Debugging` (Debugger ?) [débogueur? d’après wikipédia c’est un logiciel]
`Documentation` (technical Writer ?) [rédacteur technique] ou garder documentation
`Management` [chef-fe de projet ? superviseur ? manager ?]
- on décide de reprendre les fonctions et non pas les rôles. Ci-dessous la liste des fonctions et leurs traduction:
- coding (fr: Développement, en: Coding)
- ~~contributing / contributor (fr: Contribution , en: contributing)~~ ??? [**ACTION: A supprimer voir avec les 11 qui ont renseigné cette métadonnées**]
- maintenance ~~/ maintainer~~ (fr: maintenance, en: maintenance)
- design (fr: conception, en: design)
- architecture (fr: Architecture, en: Architecture)
- debugging (fr: débogage, en: debugging)
- https://fr.wiktionary.org/wiki/d%C3%A9bogage
- documentation (fr: Documentation, en: Documentation)
- testing (fr: Test, en: Testing)
- support (fr: Support, en: Support)
- management (fr: Management, en: Management)
- crp (fr: Auteur correspondant, en: Corresponding author) ? est-ce important d'avoir ce code ? Difficile de le renommer car il est présent pour d'autres types de documents
- **ACTION: supprimer crp**
2. Il y a une ambiguité sur le rôle `design` (ergonomie, interface ou /et algorithme) conception est plus adapté au design de l’algorithm.
Une proposition pour séparer ces deux idées:
en: `algorithm design` (design algorithm se traduit par algorithme de conception)
fr: `conception de l'algorithme`
en: `interface design` (au sens visuel)
fr: `ergonomie`
- **Décision: généraliser avec `conception` et `design`**
3. Les noms des fonctions sont plus parlantes que les noms des acteurs (`Management` est mieux que `manager`).
Par ailleurs sur l’interface graphique HAL nous avons l'instruction suivante:
> choisir la fonction
Cela dit, si on gardes les fonctions, est ce qu'on remplace `Developer` en `coding`?
4. il a une petite typo sur l'interface graphique HAL en EN, pour choisir la fonction, dans le cadre afficher il y a le mot `fonction` au lieu de `function`
- roles sur CodeMeta: https://github.com/codemeta/codemeta/issues/240
- notion de dates pour les roles
- documentation des roles
Pour l'instant nous ne pouvons pas ajouter plusieurs rôles pour une personne
* detaillé sur [#249](https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/249)
* **ACTION: La question de l'auteur en tant qu'équipe à voir pendant la prochaine réunion (préparer point pour l'agenda)**
---
#### Module
##### Ajout de la notion module dans HAL
- Exemple `isPartOf` sur HAL: https://hal.inria.fr/hal-02355563
- Exemple `hasPart` sur HAL: https://hal.inria.fr/hal-02355816
##### Le processus:
- actuellement seulement possible sur la notice ou sur:
> Mon espace/ Lier mes ressources
1. sur le dépôt hal-02355563 nous avons déclaré la rélation is part of hal-02355816
2. cette rélation apparaît sur les deux dépôts
- sans modération - A faire: ajouter modération sur toute modification?
- sans dépôt sur SWH
3. peut on déduire qu'un logiciel qui a la métadonnée `isPartOf` est un module?
4. si oui, export BibLaTeX de hal-02355563 en @softwareModule avec l'entrée hal-02355816 en @software
5. A faire: déposer les métadonées sur SWH
- **Q: modération de la relation `isPartOf` pour créer un module?**
- Ne pas utiliser les relations pour identifier un module et plustôt utiliser une collection
- `isPartOf` n'est pas approprié
- donne moi tous les éléments de cette collection et je te le transforme en BibLaTex- cela c'est possible
- un tag : qui a le pouvoir de mettre le tag?
- le créateur de la collection
- créer une catégorie
- comment produire l'entrée de la collection générale CGAL
- régler pour les autres collections dans HAL avant de le faire pour le logiciel
- qualifier les collections (en ajoutant la sémantique aux collections)
- ajouter la typologie: "je suis un module"?
- le contenant doit dire qui le contient et non pas le contenu qui dit à qui il appartient
- ACTION: faire une collection test sur la preprod avec le dépôts suivants:
* https://inria.halpreprod.archives-ouvertes.fr/view/index/docid/2510118 hal-02510118
* https://inria.halpreprod.archives-ouvertes.fr/view/index/docid/2510117 hal-02510117
- **Proposition: faire évoluer le formulaire de dépôt pour signaler un module ~~qui permet de modérer la relation `isPartOf`~~ avec la typologie `ce logiciel est un module`**
- différence entre faire évoluer le formulaire et l'export
- **Q: sur un module, quelle est la relation entre titre et sous-titre?**
- [ ] ACTION: Clarifier la spec/documentation de BibLaTeX sur l'utilisation de la propriété `title` dans un `@softwaremodule`
- `subtitle` est répandu sur BibLaTex pour ne pas ajouter plusieurs type de titre `bookTitle`,`softwareTittle`, `collectionTitle`... etc..
- cela dit, pour une recherche il faut chercher le titre du dépôt dans les deux champs (`title` & `subtitle`)
- **ACTION: fiche collection: comment créer une collection**
- **ACTION: Réflexion globale pour faire évoluer les métadonnées pour les relations**
---
### ACTION
- [ ] Morane: faire PR de correspondance CodeMeta -> HAL
- [ ] IES-INRIA: valider TEI dans la pre-prod.
- [x] Yannick: écrire les questions sur l'ajout des métadonnées au formulaire: https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/268
- [x] Yannick: supprimer crp (auteur correspondant)
- [ ] Yannick: supprimer contributeur (attendre le retour des 11 dépôts jusqu'au 22 Juin)
- [ ] IES-INRIA: voir avec les 11 dépôts avec contributeur qui ont renseigné cette métadonnée
- [ ] IES-INRIA + Morane: faire une collection test sur la preprod avec le dépôts suivants:
* https://inria.halpreprod.archives-ouvertes.fr/view/index/docid/2510118 hal-02510118
* https://inria.halpreprod.archives-ouvertes.fr/view/index/docid/2510117 hal-02510117
- [ ] écrire fiche collection: comment créer une collection suite à la collection test
- [ ] Yannick + Bruno: Réflexion globale pour faire évoluer les métadonnées pour les relations
- [ ] Morane: préparer point pour l'agenda sur la question de l'auteur en tant qu'équipe à voir pendant la prochaine réunion
---
## Réunion 2.6.2020
**Participants**
- Alain
- Jozefina
- Estelle
- Morane
**Exemples de collections**
- https://inria.halpreprod.archives-ouvertes.fr/SOFTWARE
- https://hal.inria.fr/PHARO/
**Workflow creation d'une collection**
1. créer une page collection
2. déposer un dépot logiciel d'un module (sans la possibilité de signaler que ceci est un module)
3. tamponner le dépôt avec le nom de la collection
4. export BibTex de @software et @softwaremodule depuis la collection seulement
**Les métadonnées dans la collection**
- year manquant correspond à la date du logiciel
- editor (devrait être le responsable de la collection) = demandeur(s) contact
- url = (e.g https://inria.halpreprod.archives-ouvertes.fr/TEST_SOFTWARE_MODULE1/)
- Estampilleurs ?
- TampId (e.g TEST_SOFTWARE_MODULE1) CollCode
- Title: Nom de la collection : CollCodeName (e.g `Test de la collection Software Module`)
**Les métadonnées @software**
métadonnées obligatoires:
- author/editor
- title
- year
- url
métadonnées optionnelles
- abstract = commentaire
- crossref,
- date,
- doi,
- eprint,
- eprintclass,
- eprinttype,
- hal_id, = TampId (identifiant de la collection)
- hal_version,
- institution,
- license,
- month,
- note,
- organization,
- publisher,
- related,
- relatedtype,
- relatedstring,
- repository,
- swhid,
- urldate,
- version
**Questions sur ce workflow**
1. Est ce que les chercheurs prendront ce rôle de modérateurs? pour tamponner et gérer la collection.
**Priorité: modifier la sortie bibtex actuelle avec @software et les métadonnées**
- https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-entry/-/blob/master/swentry.org
- une notice doit sortir un élément @software et un élément @softwareversion
- les modules seront introduits seulement dans une entité collection pour éventuellement l'export de la collection avec ses modules
**Conclusion**: Ajouter une métadonné `isModule` ou `estModule`
---
## Réunion 12.6.2020
### Export BibTeX à partir d'une notice logiciel
Exemple du Raweb:
```
@software{lazaar:lirmm-02146634,
TITLE = {{Constraint Acquisition Plateform}},
AUTHOR = {Lazaar, Nadjib and Bessi{\`e}re, Christian and C. Tsouros, Dimosthenis and Lee, Teddy},
URL = {https://hal-lirmm.ccsd.cnrs.fr/lirmm-02146634},
NOTE = {Software},
YEAR = {2019},
MONTH = Jun,
SWH_ID = {swh:1:dir:e7a9ce192bddc133725784f4944a28a5c711bc46},
VERSION = {version 1.0},
REPOSITORY = {https://gite.lirmm.fr/lazaar/ConstraintAcquisition},
FILE = {https://hal-lirmm.ccsd.cnrs.fr/lirmm-02146634/file/ConstraintAcquisition-master.zip},
LICENCE = {libre},
HAL_ID = {lirmm-02146634},
HAL_VERSION = {v1},
}
```
Spécifications @software sur https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-entry/blob/master/swentry.org
Required fields: `author / editor`, `title`, `url`, `year*`
Optional fields: `abstract*`, `date*`, `doi`, `eprint*`, `eprintclass*`, `eprinttype*`, `file`, `hal_id`, `hal_version`,
`institution*`, `license**`, `month`, `note**`, `organization`, `publisher*`,
`related*`, `relatedtype*`, `relatedstring*`, `repository`, `swhid`, `urldate*`, `version`
A modifier sur Raweb(**):
- `Licence` changer en `License`
- modifier l'export du contenu de `note` avec le contenu de la métadonnée `commentaire`
Export BibTeX sur HAL(*):
- ajouter la métadonnée `abstract` (resumé)
- `year` creation or publication? => date de production ou écriture
- Est ce qu'on ajoute `date` et pour quelle date (creation/publication)?
- `eprint`, `eprintclass`, `eprinttype` => ne pas ajouter
- `institution` et `publisher` ajouter à l'export après l'ajout dans le formulaire
- `related`, `relatedtype`, `relatedstring`- clarifier la description de ces métadonnées sur swentry.org et voir si on ajoute `voir aussi`(url) ou `données associés` (doi)
- `urldate` (The access date of the address specified in the url field) ?=> ne pas ajouter
**@softwareversion**
- est ce qu'on fait un export combiné avec @softwareversion? ou seulement @software?
- MG: faire seulement @software et imaginer un export de toute les versions @software avec toutes le versions déposées sur HAL avec plusieurs entrées
Ou il y a des exports BibTeX:
- HAL tools
- CV HAL
- Raweb export BibTex pour le rapport d'activité
"donne moi l'export de l'année 2019" => la version la plus récente
- est ce qu'on veut un export complet pour le logiciel (avec toutes les versions)
## Réunion 22.6.2020
**Participants**
- CCSD :
- Bruno Marmol
- Yannick Barborini
- Software Heritage :
- Roberto Di Cosmo
- Morane Gruenpeter
- IES-Inria :
- Jozéfina Sadowska
- Estelle Nivault
### Objectifs
~~1. Valider les rôles~~
2. Export BibLaTex/BibTex sur une notice seule
3. Nouveau SHWID
4. La forge Inria ferme ses portes
5. TEI
6. La collection et le module
7. Avancement sur modifications/ajouts des métadonnées et vers un export CodeMeta
8. SWHID et discussion préliminaire sur un dépôt de notice pour un contenu archiver sur SWH utilisant un SWHID
9. Auteur collectif
### Agenda + Notes
#### Export BibTeX/BibLaTeX
1. Valider export @software d'une notice simple:
Spécifications @software sur https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-entry/blob/master/swentry.org
Required fields: `author / editor`, `title`, `url`, `year*`
Optional fields: `abstract*`, `date*`, `doi`, `eprint*`, `eprintclass*`, `eprinttype*`, `file`, `hal_id`, `hal_version`,
`institution*`, `license**`, `month`, `note**`, `organization`, `publisher*`,
`related*`, `relatedtype*`, `relatedstring*`, `repository`, `swhid`, `urldate*`, `version`
Exemple du Raweb:
```
@software{lazaar:lirmm-02146634,
TITLE = {{Constraint Acquisition Plateform}},
AUTHOR = {Lazaar, Nadjib and Bessi{\`e}re, Christian and C. Tsouros, Dimosthenis and Lee, Teddy},
URL = {https://hal-lirmm.ccsd.cnrs.fr/lirmm-02146634},
NOTE = {Software},
YEAR = {2019},
MONTH = Jun,
SWH_ID = {swh:1:dir:e7a9ce192bddc133725784f4944a28a5c711bc46},
VERSION = {version 1.0},
REPOSITORY = {https://gite.lirmm.fr/lazaar/ConstraintAcquisition},
FILE = {https://hal-lirmm.ccsd.cnrs.fr/lirmm-02146634/file/ConstraintAcquisition-master.zip},
LICENCE = {libre},
HAL_ID = {lirmm-02146634},
HAL_VERSION = {v1},
}
```
Export BibTeX sur HAL(*):
- ajouter la métadonnée `abstract` (resumé)
- on utilise la meilleure date (production/écriture > publication > dépôt)
- on produit les champs `date` et `year` / `month`
- `year` et `month` doivent être la même date que `date`
- `eprint`, `eprintclass`, `eprinttype` => ne pas ajouter
- `institution` et `publisher` ajouter à l'export après l'ajout dans le formulaire
- ajouter `éditeur commercial?` (publisher) et `éditeur scientifique`(scientific editor)
- `related`, `relatedtype`, `relatedstring`- clarifier la description de ces métadonnées sur swentry.org et voir si on ajoute `voir aussi`(url) ou `données associés` (doi) ou `referencePublication` (ArXiV, HAL)
- `urldate` (The access date of the address specified in the url field) ?=> ne pas ajouter
- modifier `SWH_ID` en `SWHID`
**https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/281**
Quelques questions:
- **Q: utiliser l'entrée `@software` sur une notice ou `@softwareversion` ou les deux?**
- R: idéal d'avoir les deux
- la date du premier dépôt est la date dans @software et la date de la version est dans @softwareversion
- les auteurs? de la version?
- titre dans le @software
- dans @software les informations du logiciel sans les informations sur la version
- export compact (1 sortie @softwareversion) ou export complet (2 sorties @software et @softwareversion) sur l'interface
- s'il n'y a pas de `version` mettre la version HAL
- est ce qu'on transforme la métadonnée `version` obligatoire?
- métadonnées @software:
- title
- HAL_ID
- authors?
- date, year, month (of first deposit)
- url?
- institution
- publisher
- métadonnées @softwareversion:
- date, year, month (of version)
- code repository
- SWHID
- HAL_VERSION
- version
- file
- license
- abstract
- **Q: Est ce qu'on veut proposer les deux exports BibTex et BibLateX?**
- Pas nécessaire, car BibTeX traitera @software en @misc
- **Q: Comment gérer les autres exports qui ne sont pas BibTeX/BibLaTeX? (CV, Page web, rapport d'activité)**
- R: liste des publications- chaque publication seulement une fois. Contribution à un logiciel, on ne peut pas perdre le statut d'auteur.
- faire une entrée par logiciel
**ACTION: ajouter commentaire et lien vers le paquet BibLaTeX sur CTAN**
#### Le nouveau SWHID
Le SWHID afficher:
```
swh:1:dir:c3d06da1a556900e295b64aea1cc5a413b374ae9
```
Le SWHID sur HAL avec context et créer côté HAL avec l'url du dépôt:
```
swh:1:dir:c3d06da1a556900e295b64aea1cc5a413b374ae9;
origin=https://hal.archives-ouvertes.fr/hal-02560320;
```
Le nouveau SWHID sur Software Heritage retourner an SWORD avec 'deposit_swh_id_context':
```
swh:1:dir:c3d06da1a556900e295b64aea1cc5a413b374ae9;
origin=https://hal.archives-ouvertes.fr/hal-02560320;
visit=swh:1:snp:3e95ef6e04c381a34cc2f314576bc5644f2c797f;
anchor=swh:1:rev:2122424b547a8eca9282ba3131ec61ff1d8df7d4;
path=/
```
https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/264
- **Q: modifier le lien vers Software Heritage avec le nouveau SWHID?**
- R: garder affichage et utiliser le `deposit_swh_id_context` pour le lien vers Software Heritage
- on la voit dans la citation (relativement petit)
---
#### La forge Inria ferme ses portes
Effectivement sur Gforge il y a 8000+ projets et ne doivent pas être archiver sur HAL.
Avant que les données de la forge soient éffacées, il faut les archiver sur SWH.
Il existe des logiciels historique et important qui méritent d'avoir une notice sur HAL avec la description complète.
Réfléchir à mettre dans HAL.
Avec le workflow de dépôt des métadonnées avec un SWID, cela permet d'ajouter les logiciels sur HAL sans ajouter le contenu sur HAL.
Dépôt logiciel = soit le fichier / soit un SWHID
pas de dépôt de notice..
Est ce qu'on peut contrôler un SWHID?
https://archive.softwareheritage.org/api/1/resolve/doc/
demande de modification du logiciel = change l'identifiant
**ACTION: détailler les scénario de dépôt et de modération (IES-INRIA + Morane)**
**ACTION: écrire communication par paliers**
1. forge Inria va être archiver sur SWH (code et mailing list)
2. vous pouvez déposer dans HAL (comme avant)
3. dépôt avec SWHID sur HAL
- **Q: Pour les projets anciens et archivés ou en fin de vie le versement dans Hal + SWH me semble une solution à proposer ?**
- R:
- **Comment communiquer de manière ciblée vers les scientifiques et aussi vers les SED + DSI qui sont à l'origine de la fermeture de la forge et en première ligne auprès des utilisateurs ?**
- R:
- **Q: Un dépôt par lot de notices HAL + lien vers SWH pour les projets qui le souhaitent pourraient-il être automatisable ?**
- R:
---
#### TEI
https://docs.google.com/spreadsheets/d/1L5lIB_S8U9DnkHZMriEPX4XpwqGCkDe6eLncM8qWRJk/edit?ts=5e70c9fd&skip_itp2_check=true#gid=415198605
---
#### Discussion preliminaire sur le dépôt des métadonnées seules
1. Quels sont les cas d’utilisation et scénario des dépôts de notices sur HAL pour un SWHID
1.1. fournir un identifiant SWHID et déposer les métadonées
1.2 SWH devient un provider de métadonnées avec SWHID
- je veux les métadonnées sur ce SWHID
- un codemeta.json dans la racine-> récupèrer les métadonnées
- remplir le formulaire de métadonnées
1.3 modérer lee métadonnées sans .zip sur l'archive SWH (il n'y aura pas fichier=> pas de modération)
1.4 vérifier le contenu sur SWH et communiquer avec l'auteur si des modifications sont nécéssaires
1.5 modération accepter et la notice s'affiche sur HAL
2. Quels sont les champs
##### Implémentation Inria
1. episciences
- exemple de généreration d'un pdf avec BibLateX software
- ajouter le .bbl logiciel dans le author outil latex sur les révues épisciences.
2. RRRT style Inria - rapport technique
---
#### Metadonnées et CodeMeta
- ajouter institution [institution en EN] et editeur [publisher en EN] [#268](https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/268)
-
Nous avons collecter des exemples sur: https://hackmd.io/@HAL-SWH-IES/ByMc9kicL/edit
---
## Réunion 31.8.2020
**Participants**
- CCSD :
- Bruno Marmol ;
- Yannick Barborini
- Software Heritage :
- Morane Gruenpeter
- IES-Inria :
- Jozéfina Sadowska
### Objectifs
1. Validation formulaire du dépôt
2. Validation export TEI
3. Validation export BibLaTex/BibTex
4. Validation export codemeta.json
5. Dépôt de métadonnées:
- modification d'un dépôt logiciel sur HAL
- dépôt nouveau dépôt avec SWHID
6. Discussion export/import CodeMeta
7. Proposer l'option auteur collectif: l'auteur en tant qu'équipe
### Agenda + Notes
1. Validation formulaire du dépôt
* [tâches dans dans ce pad](https://hackmd.io/bC9vK7UORMepUR67xUtg0g#11-Le-Formumaire)
* Exemples de la preprod


* publisher-link :
* import INRAE
* ACTION: ajouter exemple (205 dépôts logiciels - notices)
* ACTION: supprimer ? oui
* 2 logiciels non INRAE
* Regarder fin 2020 les entrées pour éditeur
2. Les rôles sont en prod et les 11 contributeurs restent
* la valeur `auteur` n'existe pas dans les rôles
* peuvent pas revenir en arrière sur la valeur par défaut
* ACTION: ==IES== [rôle] contacter les 5 déposants pour les 11 rôles contributeurs
3. Validation export TEI
* [tâches dans ce pad](https://hackmd.io/bC9vK7UORMepUR67xUtg0g#11-TEI)
* [exemple sur Preprod](https://hal.halpreprod.archives-ouvertes.fr/hal-02071874v1/tei)
* ACTION: revoir les commentaires sur Google sheet
* ACTION: IES --> ouvrir tâche/s CCSD avec les commentaires
4. Validation export BibLaTex/BibTex
* [tâches dans dans ce pad](https://hackmd.io/bC9vK7UORMepUR67xUtg0g#13-BibTeX)
* [exemple sur Preprod](https://hal.halpreprod.archives-ouvertes.fr/hal-02071874v1/bibtex)
* `SWHID` et non pas `SWH_ID`
* missing `ABSTRACT`
* seulement `@softwareversion`, difficile de regarder aussi `@software` et aussi `@softwareversion` (regarder la dernière version pour @software)
* où mettre les auteurs ?
* quelles métadonnées dans quelles entrées?
* RAWEB est sur @software
* plus facile pour la version courante (dernière)
* ACTION: voir comment faire @software dans l'export?
5. Validation export codemeta.json
* [tâches dans dans ce pad](https://hackmd.io/bC9vK7UORMepUR67xUtg0g#14-CodeMeta)
* [exemple sur Preprod](https://hal.halpreprod.archives-ouvertes.fr/hal-02071874v1/codemeta)
* Commentaires sur [hack.md](https://hackmd.io/g_6J8cBETBi66R9AvPAGOA)
* DONE: copier commentaires dans une tâche CCSD (302)
6. Spécifications dépôt métadonnées sur HAL
* document de travail: https://hackmd.io/yUZAp78KTdSvE4drf0_MqQ
* modification de métadonnées
* PUT sans contenu -> mettre à jour les métadonnées
* faire un script pour tous les dépôts qui ont changés
* configuration par portail (et par type document)
* mechanisme de la gestion de la qualité
* patrouillage de post mise en ligne
* retarder la mise en ligne
* déposer sur un SWHID
* http://swordapp.github.io/SWORDv2-Profile/SWORDProfile.html#protocoloperations_creatingresource_entry
* on ne crée pas la ressource donc on fait un PUT sur un SWHID (6.5.2. Replacing the Metadata of a Resource)
* permettre de récupérer l'AtomPub sur SWH
* pas de v2 sur les notices (dépôt file)
* ACTION: spécifier les scénarios v2 (ajout de contenu)
* interdire l'ajout de contenu (niveau dépôt- utilisateur /modérateur)
7. Proposer l'option auteur collectif: l'auteur en tant qu'équipe
* problématique dans l'export BibTeX
* pas de paternité sur les dépôts
* ACTION: revoir ce point à la prochaine réunion
=> OK cf. issue : https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/315
9. Penser aux dépôts massif depuis les institutions type INRAE - comment pouvoir envoyer sur SWH
* ACTION: discuter de workflow possible pour les dépôts logiciel qui sont arrivés sur HAL depuis un dépôt massif (e.g INRAE) qui ne sont pas envoyer chez SWH.
11. HAL est prêt à récupérer tous les (nouveaux) SWHID (avec context)
* ACTION: vérifier que tous les dépôts sont correctement liés avec SWH
### Listes des actions:
Validations formulaire et formats d'exports:
* DONE=Yannick== supprimer `publisher-link` sur le formulaire [(313)](https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/313)
* DONE: ==IES-Inria== [rôle] contacter les 5 déposants pour les 11 rôles contributeurs
* ACTION: ==Morane & Yannick== [BibTeX] voir comment ajouter @software dans l'export? pour l'instant export seulement avec @softwareversion.
* DONE: ==Morane== [CodeMeta] ouvrir une tâche CCSD pour les modifications nécessaire sur l'export codemeta.json [(302)](https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/302)
* ACTION: ==Yanick== [CodeMeta] - modifier export [(302)](https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/302)
* ACTION: ==Yanick== [CodeMeta] - modifier xml SWORD
* DONE: ==IES-Inria== [TEI] ouvrir tâche CCSD avec commentaires (depuis le document Google sheet d'Estelle) - il y a déjà une issue - éventuellement à revoir le positionnement dans la TEI [(268)](https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/268)
Dépôt et modértion des métadonnées seules:
* ACTION: ==Bruno== vérifier l'option de patrouillage des modifications sur les dépôts logiciels
* ACTION: ==Morane & Jozefina==spécifier les scénarios pour dépôt d'une v2 (ajout de contenu)=> il n'y a pas de v2 sur les notices !
Autres sujets:
* DONE:==IES-Inria== Préparer et revoir à la prochaine réunion l'option de l'auteur collectif: l'auteur en tant qu'équipe [(315)](https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/315)
* ACTION: ==SWH-CCSD== discuter d'un workflow possible pour les dépôts logiciel qui sont arrivés sur HAL depuis un dépôt massif (e.g INRAE) qui ne sont pas envoyer chez SWH.
* ACTION: ==Morane== suite à la mise à jour du SWHID avec contexte- vérifier que tous les dépôts sont correctement liés avec SWH
## Réunion 28.9.2020
**Participants**
- CCSD:
- Bruno Marmol
- Yannick Barborini
- Software Heritage:
- Roberto Di Cosmo
- Morane Gruenpeter
- IES-Inria:
- Jozéfina Sadowska
- Alain Monteil
- Estelle Nivault
### Objectifs:
1. identifiant SWHID
2. auteur collectif
3. exports divers
4. modifications des dépôts logiciel
5. nouveau scénario: Dépôt métadonnées sur SWHID
### Agenda + Notes
#### 1. identifiants SWHID complet déployé
:::info
:bulb: SWHID
Le SWHID complet a été déployé et apparaît dans le cadrant `consulter` et sur le côté dans la `citation`
Exemple: https://hal.archives-ouvertes.fr/hal-01767263
:::
- valider quelques modifications à apporter au format du SWHID
- Bibtex:
- je ne trouve pas le bouton qui permet d'avoir le BibTex
- le SWHID dans le BibTeX est correct
- TEI
- Dans biblStruct```<idno type="swh">swh:1:dir:47d41cb06472ccf913aba4be5b08aeb725a8888d;origin=https://hal.archives-ouvertes.fr/hal-01767263;visit=swh:1:snp:cd55c2657ac70c9b15ae4384b6af1ae6ce8df512;anchor=swh:1:rev:b1e197c030e66d588987087a193fc3a88d8bd5ed;path=/</idno> ```
- Apparaît à d'autre endroits aussi (`<idno type="halRefHtml">`, )
- DONE: Valider le SWHID sur la TEI
- encodage
- ACTION: changer la TEI `type=swh` en `type=swhid`
#### 2. auteur collectif [(315)](https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/315):
:::info
:bulb: IES-Inria
Pouvoir créer une entrée dans le dépôt comme "auteur collectif" au sens responsabilité
Nom au sens d'un nom du collectif
:::
- Pour cette entrée pas de rôle et pas de nom ni prénom obligatoire
- Avoir un champs texte pour le libellé (ex : Givaro Group)
- Cette entrée peut avoir :
- de 0 à n affiliations
- Un mail
- une url
- pas de rôle
- coté export bibtex nous avons vue https://timmurphy.org/2011/02/15/using-an-organisation-name-as-an-author-in-bibtex/ qu'il est tout à fait possible de l'exporter sous la forme
```author = "{Givaro Group}" ```
- Bruno: pourquoi pas une structure ?
- sur la table structure AureHAL?
- responsabilité du dépôt - on ne sait pas donner la responsabilité à une structure
- les personnes qui veulent la paternité du logiciel doivent être citer personnellement sur le dépôt
- la structure est signataire
- Alain: Il faut créer un auteur côté HAL
- Roberto: exemple avec Coq : https://hal.archives-ouvertes.fr/hal-01954564
- Bruno: pas de paternité avec l'exemple coq
- Alain: idHAL? Bruno: ça marche pas.
- Les cas d'utilisations:
- rapport d'activité
- CV
- page web
- notice logiciel
- membres de l'équipe- avoir le choix d'afficher ou de ne pas afficher sur
- propriété et authorship ce n'ai pas la même chose
- être dans la citation
- ACTION: consulter un groupe (GT Citation) de chercheurs/ses, instittution / université / évaluateur sur ce point
- pas seulement les logiciels
- normes W3C, ISO
- transfert (source de vérité qui sont ailleurs)
- détacher interface et modèle de données
#### 3. exports divers
- Etat d'avancement
- TEI
- schéma AOFR spécifié (un champs qui n'y est pas)
- ACTION: Alain faire liste des champs qui manque sur le schéma AOFR sur ticket CCSD
- #268 ACTION: validation `<monogr> <imprint/>` Laurent Romary
- valider `design`
- BibTeX
- version du logiciel n'apparaît pas si https://inria.halpreprod.archives-ouvertes.fr/hal-02510601/bibtex
- info sur la distinction export @software et @softwareversion
- RAWEB: pas encore de décision si c'est l'ancien ou le nouveau avec le package BibLaTeX
- CodeMeta (json et sur SWORD)
- #302 en cours
- autres
- OAI-PMH
- DCTERMS
- RDF
- ACTION: évaluer quels exports
#### 4. modifications des métadonnées des dépôts logiciel
- modération?
- trouver les modifications - pas possible d'avoir la comparaison entre l'avant et l'après la modification
- administrateur
- patrouillage?
- contrôle qualité post modération pour le moment s'applique une fois
- évolution de l'information? non
- chantier amélioration de la qualité des données
- petit groupe pour suivre les notices
- structures qui veulent être alerté sur leurs publication
- comment s'exerce un contrôl
- ACTION: (observation) créer un petit groupe pour suivre les modifications des notices
- envoie sur SWH?
- PUT sans contenu -> mettre à jour les métadonnées
- SWHID et deposit_id obligatoire (vérification de comptabilité du côté SWH)
- ACTION: envoyer les métadonnées sur SWH
- métadonnées de logiciels modifiées après modération
- hal-01730321
- hal-01760120
- hal-01836169
- hal-01831369
- hal-01863457
- hal-01887126 (corrigé par l'IES : modification du rôle de l'un des auteurs par la fonction "Design")
- hal-01937857
- hal-02014516
- hal-02079276
- hal-02128878
- hal-02130729
- hal-02130801
#### 5. nouveau scénario: Dépôt métadonnées sur SWHID
#### Liste d'actions
- ACTION: changer la TEI `type=swh` en `type=swhid`
- ACTION: mettre à jour guides
- ACTION: consulter un groupe (GT Citation) de chercheurs/ses, instittution / université / évaluateur sur la question de l'auteur collectif
- ACTION:
- ACTION: Alain faire liste des champs qui manque sur le schéma AOFR sur ticket CCSD voir issue https://gitlab.ccsd.cnrs.fr/ccsd/hal/-/issues/325 en attente suivant evolution de la TEI
- ACTION: validation `<monogr> <imprint/>` Laurent Romary DONE => on travaille pour une insertion du codemeta pour les spécificités Logiciel prochaine réunion groupe le 24/11
- ACTION: évaluer quels autres exports (dcterms, OAI-PMH, etc.)
- ACTION: (observation) créer un petit groupe pour suivre les modifications des notices
- ACTION: envoyer les métadonnées des notices modifiées sur SWH
## Réunion 17.11.2020
**Participants**
- CCSD:
- Bruno Marmol
- Yannick Barborini
- Software Heritage:
- Roberto Di Cosmo
- Morane Gruenpeter
- IES-Inria:
- Jozéfina Sadowska
- Alain Monteil
- Estelle Nivault
### Objectifs:
1. nouveau scénario: Dépôt métadonnées sur SWHID
2. mise à jour des métadonnées envoyées
### Agenda + Notes
1. nouveau scénario: Dépôt métadonnées sur SWHID
- spécifications: https://hackmd.io/@HAL-SWH-IES/BkzfYx2MD
1.1. premier test avec Monique Teillaud (retour sur cette première expérience)

Mise en place preprod Inria puis en prod
Les tests sur la sandbox
3 modules
les SWHID au départ n'était pas accepté et cela a été résolu
a. la mise en page sur HALtools(http://haltools.inria.fr/Public/afficheRequetePubli.php?idHal=monique-teillaud&CB_auteur=oui&CB_titre=oui&CB_article=oui&CB_vignette=oui&langue=Anglais&tri_exp=annee_publi&tri_exp2=typdoc&tri_exp3=date_publi&ordre_aff=TA&Fen=Aff&css=../css/VisuOmbreVignettes.css)
ACTION INRIA va demander l'évolution de Haltools pour mieux gérer l'affichage su SWHID + proposition de mettre l'icone SWH
b. informations ne sont pas dans les mêmes lieux
c. n'est pas distribué séparément dans la collection CGAL
d. exceptions (pas dans les guides)
e. dialogue avec le déposant pour trouver les informations (AUTHORS)
f. lister bonnes pratiques - base de connaisance
g. fichier CodeMeta, si le codemeta.json contient le contenu et les informations
h. dans l'hypotèse que le déposant ne souhaite pas modifier pas le logiciel
=> ne pas accepter
i. refait le dépôt avec le nouveau SWHID- si il y a une re-génération depuis le nuage, est ce que
1.3. Implémentation
a. rendre le champs identifiant obligatoire
b. modération c'est ok
c. comment expliquer sur le formulaire que les notices sont reservées pour les dépôt avec contenu ou avec SWHID
d. bloquer les notices sans SWHID
e. qu'est ce qu'on fait avec des objets qui ne sont pas publiques? => sécurité, pas de brevets
f. cas d'utilisation - sous embargo => revenir plus tard pour le transfert
soumission dans une conférence/journal (double blind review)
g. le dépôt d'une notice de v2 n'est pas possible - notio n de version lié au c
h. faire un dépôt "fichier/file"
i. SWH peut "envoyer"
j. typé file sur l'affichage
1.4 Calendrier
a. comment on fonctionne après l'ouverture de la fonctionnalité
b. forge Inria? BIL Inria? plus généralement les reprises de données
c. CasuHAL - partager l'expérience
d. formation logiciel pour les modérateurs
e. plan de sauvegarde forge Inria?:
- Save code now
- release HAL pour les logiciels historique
f. volontariat pour les instutions pour modérer les logiciels
g. pas de spécificité pour la modération SWH
h. modération (hors Inria) suivent les guides mais le sujet "qui modère les logiciels"
premier temps seulement sur lle portail Inria
étape suivante accompagnement
reprise du fichier CodeMeta
- vérifier si un fichier existe
- récupérer le fichier
- remplir le formulaire avec les métadonnées
- https://codemeta.github.io/codemeta-generator/
- affiliation? voir l'option orcid ou mail
3. mise à jour des métadonnées envoyées
> Par contre il faudra qu’on valide à quel moment on déclenche l’envoi :
> - les métadonnées peuvent être modifiées au niveau du document (modifier les métadonnées)
> - en passant par Auréhal et la gestion des référentiels (on est plus dans le cas de corrections par lot)
a. créer une collection SWH
b. OAI-PMH interroger HAL s'il y a eu une modification
c. pas d'historique
d. on peut savoir la différence entre modification du document et modifications référentiels
e. envoyer les métadonnées au niveau du document par l'utilisateur
f. dans un deuxième temps -