diff --git a/common/modules/policyactions.org b/common/modules/policyactions.org index 51dc0e1..44f2fd2 100644 --- a/common/modules/policyactions.org +++ b/common/modules/policyactions.org @@ -1,266 +1,293 @@ #+COLUMNS: %40ITEM %10BEAMER_env(Env) %9BEAMER_envargs(Env Args) %10BEAMER_act(Act) %4BEAMER_col(Col) %10BEAMER_extra(Extra) %8BEAMER_opt(Opt) #+INCLUDE: "prelude.org" :minlevel 1 * Policy actions :PROPERTIES: :CUSTOM_ID: main :END: ** EU recommendation on access to and preservation of scientific information # Commission Recommendation (EU) 2018/790 of 25 April 2018 on access to and preservation of scientific information *** :B_column:BMCOL: :PROPERTIES: :BEAMER_col: .4 :BEAMER_env: column :END: #+ATTR_LATEX: :width .9\linewidth file:eu-2018-recomm.png #+BEAMER: \pause *** Selection from [[https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32018H0790][EU 2018 recommendation]] :B_block:BMCOL: :PROPERTIES: :BEAMER_col: .6 :BEAMER_env: block :END: /"Member States should set and implement clear policies (as detailed in national action plans) for"/ - Preservation and re-use of research outputs #+latex:\begin{quote} /"reinforcing the preservation and re-use of scientific information (publications, data sets and other research outputs)"/ #+latex:\end{quote} - Infrastructures #+latex:\begin{quote} /" further developing infrastructures underpinning the system for access to, preservation, sharing and re-use of scientific information and"/ #+latex:\end{quote} ** The French Law for a Digital Republic :PROPERTIES: :CUSTOM_ID: loilemaire :END: *** :B_column:BMCOL: :PROPERTIES: :BEAMER_col: .4 :BEAMER_env: column :END: #+ATTR_LATEX: :width .9\linewidth file:loilemaire.png #+BEAMER: \pause *** French Law for a Digital Republic (7/8/2016) :B_block:BMCOL: :PROPERTIES: :BEAMER_col: .6 :BEAMER_env: block :END: *Open up public documents* - open by default administrative documents - open by default source code of software + produced by the administration + received by the administration \hfill See [[https://www.economie.gouv.fr/files/files/PDF/DP_LoiNumerique.pdf][the official press kit]] ** French prime minister directive on data and code :PROPERTIES: :CUSTOM_ID: missionll :END: *** :B_column:BMCOL: :PROPERTIES: :BEAMER_col: .4 :BEAMER_env: column :END: #+ATTR_LATEX: :width .9\linewidth file:2021-04-27_PMFrance.png #+BEAMER: \pause *** [[https://circulaire.legifrance.gouv.fr/download/pdf/circ?id=45162][French Prime Minister directive]] (27/4/2021) :B_block:BMCOL: :PROPERTIES: :BEAMER_col: .6 :BEAMER_env: block :END: *Policy on data, algorithms and code* - step up efforts to - open up data from public administration (data.gouv.fr) - open by default source code of software + produced by the administration + received by the administration - creation of - "open source software mission" - network of "data, algorithm and code officers" *Early outcomes* - public sector source code is now being actively [[https://www.etalab.gouv.fr/code-etalab-gouv-fr-les-codes-sources-de-logiciels-publies-par-des-organismes-publics][archived in Software Heritage]] ** The Paris call: Software Source Code is our Heritage :PROPERTIES: :CUSTOM_ID: pariscall2019 :END: *** :B_column:BMCOL: :PROPERTIES: :BEAMER_col: .53 :BEAMER_env: column :END: #+ATTR_LATEX: :width .7\linewidth file:UNESCOParisCallMeeting.png UNESCO, Inria, Software Heritage invite\\ [[https://en.unesco.org/news/experts-call-greater-recognition-software-source-code-heritage-sustainable-development][40 international experts meet in Paris]] ... #+BEAMER: \pause *** :B_column:BMCOL: :PROPERTIES: :BEAMER_col: .5 :BEAMER_env: column :END: #+ATTR_LATEX: :width .65\linewidth file:paris_call_ssc_cover.jpg [[https://en.unesco.org/foss/paris-call-software-source-code][Their call is published on Feb 2019]] \pause *** :B_ignoreheading: :PROPERTIES: :BEAMER_env: ignoreheading :END: *** :PROPERTIES: :BEAMER_COL: 1.06 :BEAMER_env: block :END: It's an important /policy tool/, already referenced and used ... \hfill /yes, you can sign it!/\\ \vspace{10pt} \hfill https://en.unesco.org/foss/paris-call-software-source-code \hfill\mbox{} ** The EOSC SIRS report: Software Source Code and Open Science :PROPERTIES: :CUSTOM_ID: eoscsirs2020 :END: *** :B_column:BMCOL: :PROPERTIES: :BEAMER_col: .4 :BEAMER_env: column :END: #+ATTR_LATEX: :width .9\linewidth file:EOSC-SIRS-report.png #+BEAMER: \pause *** Important /policy tool/ in Open Science (Dec 2020) :B_block:BMCOL: :PROPERTIES: :BEAMER_col: .6 :BEAMER_env: block :END: - 9 infrastructures + 3 archives + 3 open access publishers + 3 aggregators - recommendations + *archive in Software Heritage, use SWHID* + *open non profit* + *default to open source* for research software #+latex:\begin{quote} "all research software should be made available under an Open Source license by default, and all deviations from this default practice should be properly motivated" #+latex:\end{quote} See https://doi.org/10.2777/28598 +** The EOSC SIRS report: an architecture for Source Code and Open Science + :PROPERTIES: + :CUSTOM_ID: eoscsirs2020-expanded + :END: +*** :B_column:BMCOL: + :PROPERTIES: + :BEAMER_col: .4 + :BEAMER_env: column + :END: + #+ATTR_LATEX: :width .9\linewidth + file:EOSC-SIRS-report-expanded.png + #+BEAMER: \pause +*** Important /policy tool/ in Open Science (Dec 2020) :B_block:BMCOL: + :PROPERTIES: + :BEAMER_col: .6 + :BEAMER_env: block + :END: + - 3 archives, 3 open access publishers, 3 aggregators + - recommendations + + *archive in Software Heritage* + + *use SWHID* + + *connect* with repositories, publishers and aggregators + + *open non profit* + + *default to open source* for research software + - implementation + + first steps: *FAIRCORE4EOSC* project in the EOSC + See https://doi.org/10.2777/28598 ** EOSC task force on infrastructures for quality research software :PROPERTIES: :CUSTOM_ID: eoscswtf2021 :END: *** :B_column:BMCOL: :PROPERTIES: :BEAMER_col: .4 :BEAMER_env: column :END: #+ATTR_LATEX: :width .9\linewidth file:EOSC-SWI-TF.png #+BEAMER: \pause *** Ongoing action in the EOSC :B_block:BMCOL: :PROPERTIES: :BEAMER_col: .6 :BEAMER_env: block :END: *Task force on infrastructures for quality research software* - Foster the development and deployment of tools and services that allow researchers to properly archive, reference, describe with proper metadata, share and reuse research software. - Improve the quality of research software, both from the technical and organizational point of view ... - Increase recognition to software developers and maintainers of research software ... See [[https://www.eosc.eu/sites/default/files/tfcharters/eosca_tfinfrastructureforqualityresearchsoftware_draftcharter_20210614.pdf][the charter of the task force]]. ** The UNESCO recommendations for Open Science :PROPERTIES: :CUSTOM_ID: unesco2021 :END: #+BEAMER: \vspace{-1em} *** :B_column:BMCOL: :PROPERTIES: :BEAMER_col: .4 :BEAMER_env: column :END: #+ATTR_LATEX: :width .9\linewidth file:UNESCO-open-science-draft.png #+BEAMER: \pause *** Selection from [[https://unesdoc.unesco.org/ark:/48223/pf0000378381.locale=en][the recommendations]] :B_block:BMCOL: :PROPERTIES: :BEAMER_col: .6 :BEAMER_env: block :END: - Open Source for Open Science #+latex:\begin{quote} /"The source code must be included in the software release and made available on openly accessible repositories and the chosen license must allow modifications, derivative works and sharing under equal or compatible open terms and conditions"/ #+latex:\end{quote} - Infrastructures #+latex:\begin{quote} /"Open science infrastructures should be organized and financed upon an essentially not-for-profit and long-term vision, which enhance open science practices and guarantee permanent and unrestricted access to all, to the largest extent possible."/ #+latex:\end{quote} ** French National plan for Open Science :PROPERTIES: :CUSTOM_ID: pnso2 :END: *** :B_column:BMCOL: :PROPERTIES: :BEAMER_col: .4 :BEAMER_env: column :END: - #+ATTR_LATEX: :width .9\linewidth + #+ATTR_LATEX: :width .85\linewidth file:PNSO2-en-cover.png #+BEAMER: \pause *** 2nd National Plan for Open Science (6/7/2021) :B_block:BMCOL: :PROPERTIES: :BEAMER_col: .6 :BEAMER_env: block :END: *Open and promote research software source code* - actions (selection) - charter for research software policy - recognize software development (see [[https://www.ouvrirlascience.fr/ouverture-des-candidatures-du-prix-science-ouverte-du-logiciel-libre-de-la-recherche/][announcement of the 2021 prize]]) - coordinate communities of practice - - build a connected ecosystem of research outputs + - connected ecosystem of research outputs - recommendations (selection) + *archive in Software Heritage* + *standardise and use SWHID* + *build a national catalog of research software* + *leverage ADAC network* \hfill See [[https://www.enseignementsup-recherche.gouv.fr/cid159131/le-plan-national-pour-la-science-ouverte-2021-2024-vers-une-generalisation-de-la-science-ouverte-en-france.html][official announcement]] ** French National Roadmap for Research Infrastructures :PROPERTIES: :CUSTOM_ID: roadmap2022 :END: *** :B_column:BMCOL: :PROPERTIES: :BEAMER_col: .4 :BEAMER_env: column :END: #+ATTR_LATEX: :width .9\linewidth file:feuille_de_route_DGRI_2021.png #+BEAMER: \pause *** National Roadmap of Research Infrastructures (2022-...) :B_block:BMCOL: :PROPERTIES: :BEAMER_col: .65 :BEAMER_env: block :END: *Framework* #+BEGIN_QUOTE "The strategic, scientific and financial challenges related to research infrastructures are such that sooner or later we will need to jointly program European and national investments in major research facilities." #+END_QUOTE \mbox{}\hfill Frédérique Vidal, Minister of Research, 2018 # https://www.enseignementsup-recherche.gouv.fr/sites/default/files/imported_files/documents/Brochure_Infrastructures_2018_UK_1023046.pdf *Software Heritage is now listed* #+BEGIN_QUOTE "Software Heritage will be included in the national roadmap of research infrastructures in the Project category." #+END_QUOTE \mbox{}\hfill Claire Giry, DGRI, MESRI, 2021 diff --git a/common/modules/swh-ardc.org b/common/modules/swh-ardc.org index b536360..38cc678 100644 --- a/common/modules/swh-ardc.org +++ b/common/modules/swh-ardc.org @@ -1,421 +1,421 @@ #+COLUMNS: %40ITEM %10BEAMER_env(Env) %9BEAMER_envargs(Env Args) %10BEAMER_act(Act) %4BEAMER_col(Col) %10BEAMER_extra(Extra) %8BEAMER_opt(Opt) # # Software is all around us # #+INCLUDE: "prelude.org" :minlevel 1 #+INCLUDE: "169.org" * Source code pillar of Open Science, and how Software Heritage addresses ARDC :PROPERTIES: :CUSTOM_ID: main :END: ** Source code is /special/ (software is /not/ data) :PROPERTIES: :CUSTOM_ID: swnotdata :END: *** /Executable/ and /human readable/ knowledge \hfill copyright law :noexport: /“Programs must be written for people to read, and only incidentally for machines to execute.”/\\ \hfill Harold Abelson #+BEAMER: \pause *** Software /evolves/ over time - projects may last decades - the /development history/ is key to its /understanding/ #+BEAMER: \pause *** Complexity :B_picblock: :PROPERTIES: :BEAMER_env: picblock :BEAMER_OPT: pic=python3-matplotlib.pdf, width=.6\linewidth :END: - /millions/ of lines of code - large /web of dependencies/ + easy to break, difficult to maintain + /research software/ a thin top layer - sophisticated /developer communities/ *** :B_ignoreheading: :PROPERTIES: :BEAMER_env: ignoreheading :END: #+BEAMER: \pause *** Precious, endangered /executable/ and /human readable/ knowledge key people *passing away*, platforms (GoogleCode, Gitorious, etc.) closing down ...\\ \hfill no organised effort to catalog and archive it ** Source code is /special/, cont'd :PROPERTIES: :CUSTOM_ID: swnotdatacontd :END: *** Software is complex - Structure :: monolithic/composite; self-contained/external dependencies - Lifetime :: one-shot/long term - Community :: one man/one team/distributed community - Authorship :: multiple roles: Architecture, Management, Development, Documentation, Testing, ... - Authority :: institutions/organizations/communities/single person #+BEAMER: \pause *** Versioning, granularity - Project :: “Inria created OCaml and Scikit-learn”\pause - Release :: “2D Voronoi Diagrams were introduced in CGAL 3.1.0”\pause - Exact state of a project :: “This result was produced using commit 0064fbd...”\pause - Code fragment :: “The core algorithm is in lines 101 to 143 of the file parmap.ml contained in the precise state of the project corresponding to commit 0064fbd....” ** Software Source code: pillar of Open Science, multiple needs :PROPERTIES: :CUSTOM_ID: pillaropensciencecompact :END: *** Three pillars of Open Science :B_block: :PROPERTIES: :BEAMER_env: block :BEAMER_COL: .4 :END: #+latex: \begin{center} #+ATTR_LATEX: :width \extblockscale{1.2\linewidth} file:PreservationTriangle.png #+latex: \end{center} #+BEAMER: \pause *** A plurality of needs :B_block: :PROPERTIES: :BEAMER_env: block :BEAMER_COL: .6 :END: - Researcher :: - *archive* and *reference* software used in articles - *find* useful software - get *credit* for developed software - verify/reproduce/improve results #+BEAMER: \pause - Laboratory/team :: track software contributions - produce reports / web page #+BEAMER: \pause - Research Organization :: know its *software assets* - technology *transfer* - impact *metrics* ** Software Source code: a pillar of Open Science :PROPERTIES: :CUSTOM_ID: pillaropenscience :END: #+BEAMER: \vspace{-.5em} *** Software powers modern research :B_picblock: :PROPERTIES: :BEAMER_opt: pic=papermountain, leftpic=true, width=.4\linewidth :BEAMER_env: picblock :BEAMER_COL: .64 :END: #+BEGIN_QUOTE [...] software [...] essential in their fields. \mbox{}\hfill Top 100 papers (Nature, 2014) \vspace{.5em} #+END_QUOTE #+BEGIN_QUOTE Sometimes, if you dont have the software, you dont have the data \mbox{}\hfill Christine Borgman, Paris, 2018 #+END_QUOTE # http://www.nature.com/news/the-top-100-papers-1.16224 #+BEAMER: \pause *** Missing pillar: software (source code) :B_block: :PROPERTIES: :BEAMER_COL: .42 :BEAMER_env: block :END: #+latex: \begin{center} #+ATTR_LATEX: :width \extblockscale{1.2\linewidth} file:preservation_triangle_color.png #+latex: \end{center} #+BEAMER: \pause \hfill The links in the picture are *important* *** :B_ignoreheading: :PROPERTIES: :BEAMER_env: ignoreheading :END: #+BEAMER: \pause *** Nota Bene software may be a /tool/, a /research outcome/ and a /research object/\pause\\ \hfill access to the /source code/ is essential! ** A plurality of needs :PROPERTIES: :CUSTOM_ID: userneeds :END: *** Researchers **** :B_column: :PROPERTIES: :BEAMER_env: column :BEAMER_COL: .58 :END: - *archive* and *reference* software used in articles - *find* useful software **** :B_column: :PROPERTIES: :BEAMER_env: column :BEAMER_COL: .46 :END: - get *credit* for developed software - verify, *reproduce*, improve results #+BEAMER: \pause *** Laboratories/teams **** :B_column: :PROPERTIES: :BEAMER_env: column :BEAMER_COL: .4 :END: - *track* software contributions **** :B_column: :PROPERTIES: :BEAMER_env: column :BEAMER_COL: .5 :END: - produce reports - maintain web page #+BEAMER: \pause *** Research Organization know its *software assets* **** :B_column: :PROPERTIES: :BEAMER_env: column :BEAMER_COL: .4 :END: + technology *transfer* + impact *metrics* **** :B_column: :PROPERTIES: :BEAMER_env: column :BEAMER_COL: .5 :END: + funding *strategy* + career *evaluation* ** What is at stake: ARDC \hfill in increasing order of difficulty :PROPERTIES: :CUSTOM_ID: ardc :END: *** Archive Research software artifacts must be properly *archived*\\ \hfill make sure we can /retrieve/ them (/reproducibility/) #+BEAMER: \pause *** :B_ignoreheading: :PROPERTIES: :BEAMER_env: ignoreheading :END: \vspace{-.5em} *** Reference Research software artifacts must be properly *referenced*\\ \hfill make sure we can /identify/ them (/reproducibility/) #+BEAMER: \pause *** :B_ignoreheading: :PROPERTIES: :BEAMER_env: ignoreheading :END: \vspace{-.5em} *** Describe Research software artifacts must be properly *described*\\ \hfill make it easy to /discover/ and /reuse/ them (/visibility/) #+BEAMER: \pause *** :B_ignoreheading: :PROPERTIES: :BEAMER_env: ignoreheading :END: \vspace{-.5em} *** Cite/Credit Research software artifacts must be properly *cited* /(not the same as referenced!)/\\ \hfill to give /credit/ to authors (/evaluation/!) *** :B_ignoreheading: :PROPERTIES: :BEAMER_env: ignoreheading :END: ** What is at stake: before ARDC :PROPERTIES: :CUSTOM_ID: beforeardc :END: *** Development practices and tools - version control system - key metadata information (README, AUTHORS, LICENCE, etc.) - build system - test suites - continuous integration - ... *** Opening up - documentation - community building - ... *** needs proper training, and identification of best practices ** What is at stake: beyond ARDC :PROPERTIES: :CUSTOM_ID: beyondardc :END: *** Policy framework for dissemination, reuse, evaluation and recognition Define and promote an open source policy for publicly funded research software, including incentives and recognition for researchers and engineers #+BEAMER: \pause *** Sustainability Organisational schemas, legal tools, economic models, processes and policies to ensure research software can be maintained and sustained over time #+BEAMER: \pause *** Technology transfer and industry collaboration Approaches, support, methods, processes to establish connections with industry in order to foster uptake and transfer of research software #+BEAMER: \pause *** Advanced technologies and tools software quality reproducibility, and traceability (including plagiarism detection) ** What is at stake: beyond ARDC :PROPERTIES: :CUSTOM_ID: beyondardc-evaluation :END: *** Sustainability, technology transfer Organisational schemas, legal tools, economic models, processes and policies to ensure research software can be maintained and sustained over time, maybe in connection with industry #+BEAMER: \pause *** Evaluation (funding, careers, etc.) \hfill beware of /naive software citation counting/! + human-in-the-loop evaluation (see the [[https://www-enseignementsup--recherche-gouv-fr.translate.goog/fr/remise-des-prix-science-ouverte-du-logiciel-libre-de-la-recherche-83576?_x_tr_sl=fr&_x_tr_tl=en&_x_tr_hl=en-US&_x_tr_pto=wapp][French National Prize]]) + identify /roles/ in software projects, see: #+BEGIN_EXPORT latex \begin{thebibliography}{Foo Bar, 1969} \footnotesize \bibitem{alliez:hal-02135891} P. Alliez, R. Di Cosmo, B. Guedj, A. Girault, M.-S. Hacid, A. Legrand and N. Rougier\newblock \emph{Attributing and referencing (research) software: Best practices and outlook from Inria}, \newblock CiSE 2020 \href{https://doi.ieeecomputersociety.org/10.1109/MCSE.2019.2949413}{(10.1109/MCSE.2019.2949413)} \end{thebibliography} #+END_EXPORT #+BEAMER: \pause *** Regulations are coming software management plans, licensing, metadata and identification standards ** Addressing the four ARDC needs (see [[https://dx.doi.org/10.1007/978-3-030-52200-1_36][ICMS 2020]] for details) :PROPERTIES: :CUSTOM_ID: swh-ardc-short :END: -*** Archive (10B+ files, 150M+ projects) +*** Archive (12B+ files, 170M+ projects) :PROPERTIES: :BEAMER_env: block :BEAMER_COL: .5 :END: #+ATTR_LATEX: :width .8\linewidth file:swh-dataflow-merkle.pdf \vspace{-1em} #+BEAMER: \pause - [[https://save.softwareheritage.org][save.softwareheritage.org]] - [[https://deposit.softwareheritage.org][deposit.softwareheritage.org]] # (HAL, IPOL) #+BEAMER: \pause *** Reference (20 billion SWHIDs) :B_block: :PROPERTIES: :BEAMER_env: block :BEAMER_COL: .5 :END: [[https://www.softwareheritage.org/2020/07/09/intrinsic-vs-extrinsic-identifiers/][Intrinsic, decentralised, cryptographically strong identifiers, SWHIDs]] \vspace{-1em} #+ATTR_LATEX: :width 1.02\linewidth file:SWHID-v1.4_3.png Now supported [[https://www.softwareheritage.org/2020/05/13/swhid-adoption/][in SPDX 2.2, Wikidata]] etc. #+BEAMER: \pause *** :B_ignoreheading: :PROPERTIES: :BEAMER_env: ignoreheading :END: *** Describe :B_block: :PROPERTIES: :BEAMER_env: block :BEAMER_COL: .5 :END: - /Intrinsic metadata/ from source code - Contributed the [[https://codemeta.github.io/codemeta-generator/][Codemeta generator]] #+BEAMER: \pause *** Cite/Credit :B_block: :PROPERTIES: :BEAMER_env: block :BEAMER_COL: .5 :END: - Contributed /software citation/ style [[https://www.ctan.org/tex-archive/macros/latex/contrib/biblatex-contrib/biblatex-software][biblatex-software, v 1.2-2 now on CTAN]] ** Addressing the A(archive) in ARDC (see [[https://dx.doi.org/10.1007/978-3-030-52200-1_36][ICMS 2020]] for details) :PROPERTIES: :CUSTOM_ID: swh-a :END: #+latex: \vspace{-0.8em} *** /Universal/ source code archive \hfill /not only research/ \hfill (12B+ files, 170M+ projects) :PROPERTIES: :BEAMER_env: block :END: #+ATTR_LATEX: :width .6\linewidth file:swh-dataflow-merkle.pdf #+latex: \vspace{-1em} - your research software /is likely there already/! #+BEAMER: \pause - anyone can trigger archival with [[https://save.softwareheritage.org][save.softwareheritage.org]] #+BEAMER: \pause - selected partners can push to the archive via [[https://deposit.softwareheritage.org][deposit.softwareheritage.org]] # (HAL, IPOL) ** Addressing the R(eference) in ARDC (see [[https://dx.doi.org/10.1007/978-3-030-52200-1_36][ICMS 2020]] for details) :PROPERTIES: :CUSTOM_ID: swh-r :END: #+latex: \vspace{-0.8em} *** Software Heritage Identifiers (SWHID) \hfill [[https://docs.softwareheritage.org/devel/swh-model/persistent-identifiers.html][link to full docs]] :B_block: :PROPERTIES: :BEAMER_env: block :END: 20+B [[https://www.softwareheritage.org/2020/07/09/intrinsic-vs-extrinsic-identifiers/][intrinsic, decentralised, cryptographically strong identifiers, SWHIDs]] # #+INCLUDE: "../../common/modules/swh-id-syntax.org::#swh-id-syntax" :only-contents t :minlevel 3 #+LATEX: \centering%\forcebeamerstart #+LATEX: \mode{\only<1>{\includegraphics[width=0.8\linewidth]{SWHID-v1.4_1.png}}} #+LATEX: \mode{\only<2>{\includegraphics[width=0.8\linewidth]{SWHID-v1.4_2.png}}} #+LATEX: \only<3->{\includegraphics[width=0.8\linewidth]{SWHID-v1.4_3.png}} #+LATEX: %\forcebeamerend *** vspace :B_ignoreheading: :PROPERTIES: :BEAMER_env: ignoreheading :END: #+latex: \vspace{-0.5em} *** :PROPERTIES: :BEAMER_act: <4-> :BEAMER_env: block :END: Emerging standard : Linux Foundation [[https://spdx.github.io/spdx-spec/appendix-VI-external-repository-identifiers/#persistent-id][SPDX 2.2]]; IANA registered; WikiData [[https://www.wikidata.org/wiki/Property:P6138][P6138]] *** vspace :B_ignoreheading: :PROPERTIES: :BEAMER_env: ignoreheading :END: #+latex: \vspace{-0.5em} *** Full fledged /source code references/ for reproducibility :B_block: :PROPERTIES: :BEAMER_act: <5-> :BEAMER_env: block :END: Examples: [[https://archive.softwareheritage.org/swh:1:cnt:64582b78792cd6c2d67d35da5a11bb80886a6409;origin=https://github.com/virtualagc/virtualagc;lines=245-261/][Apollo 11 AGC excerpt]], [[https://archive.softwareheritage.org/swh:1:cnt:bb0faf6919fc60636b2696f32ec9b3c2adb247fe;origin=https://github.com/id-Software/Quake-III-Arena;lines=549-572/][Quake III rsqrt]]; Guidelines available, see [[https://dx.doi.org/10.1007/978-3-030-52200-1_36][ICMS 2020]] ** Addressing D(escribe) and C(ite) in ARDC (see [[https://dx.doi.org/10.1007/978-3-030-52200-1_36][ICMS 2020]] for details) :PROPERTIES: :CUSTOM_ID: swh-dc :END: *** Describe :B_block: :PROPERTIES: :BEAMER_env: block :BEAMER_COL: .5 :END: - Collect /intrinsic metadata/ - Contributed the [[https://codemeta.github.io/codemeta-generator/][Codemeta generator]] #+ATTR_LATEX: :width .8\linewidth file:CodeMetaGenerator.png #+BEAMER: \pause *** Cite/Credit :B_block: :PROPERTIES: :BEAMER_env: block :BEAMER_COL: .5 :END: - Contributed /software citation/ style [[https://www.ctan.org/tex-archive/macros/latex/contrib/biblatex-contrib/biblatex-software][biblatex-software, v 1.2-2 now on CTAN]] #+ATTR_LATEX: :width .8\linewidth file:BibLaTeX-swh.png ** ARDC Best practices :PROPERTIES: :CUSTOM_ID: ardc-best-france :END: *** Archiving and referencing For *all source code* used in research (/yes, even small scripts!/) - ensure it is archived in Software Heritage (see [[https://save.softwareheritage.org/][save code now]]) - - get the proper *SWHID* for your software (see demo and [[https://www.softwareheritage.org/howto-archive-and-reference-your-code/][detailed HOWTO]]) - - add it to research articles for reproducibility (see demo and [[https://www.softwareheritage.org/howto-archive-and-reference-your-code/][detailed HOWTO]]) + - get the proper *SWHID* for your software (see [[https://www.softwareheritage.org/howto-archive-and-reference-your-code/][detailed HOWTO]]) + - add it to research articles for reproducibility (see [[https://www.softwareheritage.org/howto-archive-and-reference-your-code/][detailed HOWTO]]) #+BEAMER: \pause *** Describing and Citing/Crediting For *software you want to put forward* (/mention in your CV, reports, etc., get citations and credit for it/), do the following *extra steps*: - - add *codemeta.json* with description (see demo and the [[https://codemeta.github.io/codemeta-generator/][codemeta generator]]) - - reference it in the HAL portal (see demo and online documentation) + - add *codemeta.json* with description (see the [[https://codemeta.github.io/codemeta-generator/][codemeta generator]]) + - reference in the HAL portal (french partners, see [[https://doc.archives-ouvertes.fr/en/deposit/deposit-software-source-code/][online HAL documentation]]) - cite software using the [[https://ctan.org/pkg/biblatex-software][biblatex-software]] package (in CTAN and TeXLive)