diff --git a/common/images/stories/CM.png b/common/images/stories/CM.png new file mode 100644 index 0000000..273dbbf Binary files /dev/null and b/common/images/stories/CM.png differ diff --git a/common/images/stories/EM.png b/common/images/stories/EM.png new file mode 100644 index 0000000..264ded9 Binary files /dev/null and b/common/images/stories/EM.png differ diff --git a/common/images/stories/GS.png b/common/images/stories/GS.png new file mode 100644 index 0000000..74b439c Binary files /dev/null and b/common/images/stories/GS.png differ diff --git a/common/images/stories/KSN.png b/common/images/stories/KSN.png new file mode 100644 index 0000000..806a579 Binary files /dev/null and b/common/images/stories/KSN.png differ diff --git a/common/images/stories/KT.png b/common/images/stories/KT.png new file mode 100644 index 0000000..89d837d Binary files /dev/null and b/common/images/stories/KT.png differ diff --git a/common/images/stories/LB.png b/common/images/stories/LB.png new file mode 100644 index 0000000..d7ea6c2 Binary files /dev/null and b/common/images/stories/LB.png differ diff --git a/common/images/stories/MG.png b/common/images/stories/MG.png new file mode 100644 index 0000000..351da3b Binary files /dev/null and b/common/images/stories/MG.png differ diff --git a/common/images/stories/RDC.png b/common/images/stories/RDC.png new file mode 100644 index 0000000..d72a81a Binary files /dev/null and b/common/images/stories/RDC.png differ diff --git a/common/images/stories/placeholder.png b/common/images/stories/placeholder.png new file mode 100644 index 0000000..2c27aae Binary files /dev/null and b/common/images/stories/placeholder.png differ diff --git a/common/modules/forges-not-archives.org b/common/modules/forges-not-archives.org index a8e5b5b..e045ee4 100644 --- a/common/modules/forges-not-archives.org +++ b/common/modules/forges-not-archives.org @@ -1,43 +1,88 @@ #+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" * Forges, distribution platforms, archives, and why they are different :PROPERTIES: :CUSTOM_ID: main :END: ** Where is the source code? :PROPERTIES: :CUSTOM_ID: categories :END: *** Collaborative development platforms (aka "forges") - BitBucket, GitLab(.com), GitHub, etc. - support for version control, issues, etc. - example: + https://github.com/rdicosmo/parmap + https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-entry/ #+BEAMER: \pause *** Distribution platforms - CTAN, CRAN, PyPi, Debian, etc. - example: https://ctan.org/pkg/biblatex-software #+BEAMER: \pause *** Archives - Software Heritage - example: [[https://archive.softwareheritage.org/swh:1:dir:92a6d0b9953aa3645ffac6bb4fb30a02932872eb;origin=https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-entry;visit=swh:1:snp:05753fe748b7b85cbd0a9e2bea89aac5268b06c6;anchor=swh:1:rev:7c621448de21b0950cdff2dda37834cd4b389bfa][archived version of biblatex-software]] +** Some popular approaches to preservation + :PROPERTIES: + :CUSTOM_ID: oldapproaches + :END: +*** A - Since the \sout{1970's} 1990's :B_block: + :PROPERTIES: + :BEAMER_env: block + :BEAMER_COL: .45 + :END: + .zip or .tar file on: + - \sout{ftp server} + - *web page* + - *document archive* (+ DOI) + #+BEAMER: \pause +*** B - Since the 2000's + :PROPERTIES: + :BEAMER_env: block + :BEAMER_COL: .45 + :END: + Rely on /software forges/ + - institutional or project ones + - free commercial ones: BitBucket, GitHub, GitLab, ... + #+BEAMER: \pause +*** :B_ignoreheading: + :PROPERTIES: + :BEAMER_env: ignoreheading + :END: +*** C: a mix of the two :B_block: + :PROPERTIES: + :BEAMER_COL: .5 + :BEAMER_env: block + :END: + # Use redacted version of https://dl.acm.org/do/10.1145/3211988/full/ + #+ATTR_LATEX: :width .6\linewidth + file:acmdl-redacted.png + #+BEAMER: \pause +*** Can get no satisfaction... :B_block: + :PROPERTIES: + :BEAMER_COL: .5 + :BEAMER_env: block + :END: + - A :: /Poor user experience/ + - B :: /Preservation?/ + - C :: Can do better + ** Forges are /not/ archives! :PROPERTIES: :CUSTOM_ID: evidence :END: *** 2015: the first big bad news Google Code and Gitorious.org shutdown: ~1M endangered repositories - broken links in the web of knowledge (my papers too) #+BEAMER: \pause *** Big bad news keep coming in - summer 2019: BitBucket announces Mercurial VCS sunset - july 2020: BitBucket erases /250.000+/ repositories (including research software) - summer 2022: GitLab.com considers erasing *all* projects that are *inactive for a year* #+BEAMER: \pause *** In Academia too! - 2021: Inria's old gforge is unplugged... [[https://github.com/ocaml/opam-repository/issues/19757][breaks the Opam build chain]] for OCaml diff --git a/common/modules/policyactions.org b/common/modules/policyactions.org index b72ad7a..a82387f 100644 --- a/common/modules/policyactions.org +++ b/common/modules/policyactions.org @@ -1,490 +1,527 @@ #+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 :PROPERTIES: :CUSTOM_ID: eurecomm2018 :END: # 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 +** The Paris call: Software Source Code as 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 Paris Call on Software Source code (2019, UNESCO) :PROPERTIES: :CUSTOM_ID: pariscall2019science :END: #+BEAMER: \vspace{-.8em} *** :B_column:BMCOL: :PROPERTIES: :BEAMER_col: .53 :BEAMER_env: column :END: #+ATTR_LATEX: :width .65\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 to meet in Paris]] #+BEAMER: \pause *** :B_column:BMCOL: :PROPERTIES: :BEAMER_col: .5 :BEAMER_env: column :END: #+ATTR_LATEX: :width .6\linewidth file:paris_call_ssc_cover.jpg [[https://en.unesco.org/foss/paris-call-software-source-code][The call is published on Feb 2019]]\pause *** :B_ignoreheading: :PROPERTIES: :BEAMER_env: ignoreheading :END: # #+BEAMER: \vspace{-.3em} *** :PROPERTIES: :BEAMER_COL: 1.06 :BEAMER_env: block :END: #+LATEX: {\it “[We call to] promote software development as a valuable research activity, and research software as a key enabler for Open Science/Open Research, sharing good practices and recognising in the careers of academics their contributions to high quality software development, in all their forms” #+LATEX: } https://en.unesco.org/foss/paris-call-software-source-code +** The Paris Call on Software Source code: legacy preservation + :PROPERTIES: + :CUSTOM_ID: pariscall2019heritage + :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][The call is published on Feb 2019]]\pause +*** :B_ignoreheading: + :PROPERTIES: + :BEAMER_env: ignoreheading + :END: +*** + :PROPERTIES: + :BEAMER_COL: 1.06 + :BEAMER_env: block + :END: + “[We call to] support efforts to gather and preserve the artifacts and + narratives of the history of computing, while the earlier creators are still + alive” + \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*, *connect* it with repositories, publishers and aggregators + *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} - implementation: first steps via *FAIRCORE4EOSC* 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]]. ** Software in the EOSC (in a nutshell) :PROPERTIES: :CUSTOM_ID: eoscswshort :END: *** :B_column:BMCOL: :PROPERTIES: :BEAMER_col: .5 :BEAMER_env: column :END: #+ATTR_LATEX: :width .8\linewidth file:EOSC-SIRS-report-expanded.png #+BEAMER: \pause *** :B_column:BMCOL: :PROPERTIES: :BEAMER_col: .5 :BEAMER_env: column :END: #+ATTR_LATEX: :width .7\linewidth file:EOSC-SWI-TF.png ** 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} ** First French National plan for Open Science \hfill official slides :PROPERTIES: :CUSTOM_ID: pnso1-official :END: *** :B_column: :PROPERTIES: :BEAMER_env: column :BEAMER_COL: .5 :END: #+BEAMER: \includegraphics[page=1,width=\linewidth]{PNSO1.pdf} #+BEAMER: \includegraphics[page=2,width=\linewidth]{PNSO1.pdf} #+BEAMER: \pause *** :B_column: :PROPERTIES: :BEAMER_env: column :BEAMER_COL: .5 :END: #+BEAMER: \includegraphics[page=3,width=\linewidth]{PNSO1.pdf} #+BEAMER: \includegraphics[page=4,width=\linewidth]{PNSO1.pdf} ** 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 .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 - 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 plan for Open Science \hfill official slides :PROPERTIES: :CUSTOM_ID: pnso2-official :END: *** :B_column: :PROPERTIES: :BEAMER_env: column :BEAMER_COL: .5 :END: #+BEAMER: \includegraphics[page=1,width=\linewidth]{PNSO2-sw.pdf} #+BEAMER: \includegraphics[page=2,width=\linewidth]{PNSO2-sw.pdf} #+BEAMER: \pause *** :B_column: :PROPERTIES: :BEAMER_env: column :BEAMER_COL: .5 :END: #+BEAMER: \includegraphics[page=3,width=\linewidth]{PNSO2-sw.pdf} #+BEAMER: \includegraphics[page=4,width=\linewidth]{PNSO2-sw.pdf} ** 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* # # Text below now outdated: SWH est dans la feuille de route publiee en fevrier 2022 # # #+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 ** First national Open Science awards for research software (2022) :PROPERTIES: :CUSTOM_ID: awards2022 :END: #+ATTR_LATEX: :width .8\textwidth file:2022-PNLR-awards.png * Context about Open Science :PROPERTIES: :CUSTOM_ID: context :END: ** Why Open Science? :PROPERTIES: :CUSTOM_ID: whyopenscience :END: #+BEAMER: \vspace{-.5em} *** Open Science ([[https://www.ouvrirlascience.fr/wp-content/uploads/2021/10/Second_French_Plan-for-Open-Science_web.pdf][Second National Plan for Open Science]], France, 2021) /Unhindered/ dissemination of results, methods and products from scientific research.\\ It draws on /the opportunity provided by recent digital progress/ to develop /open access/ to /publications/ and – as much as possible – /data/, /source code/ and /research methods/. #+BEAMER: \pause #+BEAMER: \vspace{-.3em} *** Jean-Eric Paquet (EU DGRI, [[https://www.eosc.eu/sites/default/files/EOSC-SRIA-V1.0_15Feb2021.pdf][on the objective of Open Science]]) # Preface of EOSC SRIA https://www.eosc.eu/sites/default/files/EOSC-SRIA-V1.0_15Feb2021.pdf “Increase /scientific quality/, the /pace of discovery and technological development/, as well as /societal trust in science/.” #+BEAMER: \pause #+BEAMER: \vspace{-.1em} *** Mariya Gabriel ([[https://www.s4d4c.eu/insights-from-commissioner-mariya-gabriel-towards-the-european-union-science-diplomacy/][EU Commissionneer]] for Research) # From the article: https://www.s4d4c.eu/insights-from-commissioner-mariya-gabriel-towards-the-european-union-science-diplomacy/ The COVID-19 crisis has also shown that cooperation at international level in research and innovation is more important than ever, including through /open access to data and results/. /No nation, no country can tackle any of these global challenges alone/. #+BEAMER: \pause #+BEAMER: \vspace{-.3em} *** Yuval Noah Harari (on COVID 19) \hfill /“The real antidote [to epidemic] is/ scientific knowledge /and/ global cooperation.” ** Two well known pillars of Open Science :PROPERTIES: :CUSTOM_ID: otherpillars :END: *** Open Access (a long, painful, unfinished story) + 19XX's :: compulsory exclusive copyright transfer to publishers (unlawful?)\pause\\ (notable exceptions: [[https://www.usa.gov/government-works#item-206099][US federal agencies]] and [[https://www.nationalarchives.gov.uk/information-management/re-using-public-sector-information/uk-government-licensing-framework/crown-copyright/][UK Crown Copyright]])\pause + 1990's :: Internet, Web and ArXiv break the [[https://hal.archives-ouvertes.fr/hal-03362932][marriage of convenience of researchers with publishers]]\pause + 2000's :: declarations (Budapest, 2001; Berlin 7, 2009) and actions (LIPIcs, 2009)\pause # for LIPIcs, see https://mail.google.com/mail/u/0/?zx=x1hap3qcat7#search/anca.muscholl%40u-bordeaux.fr/FMfcgxwLtGsWZGhGxJfZlzsVGCctLmQV?projector=1&messagePartId=0.1.1 + 2010's :: reactions (SciHub, 2011; [[https://www.coalition-s.org/][Plan S]], 2018) and transformations ([[https://www.ouvrirlascience.fr/transformative-agreements-what-effects-on-the-economics-of-academic-publishing/][not so easy]])\pause \hfill TL;DR: see [[https://hal.archives-ouvertes.fr/hal-03362932][my viewpoint in 2005]] and [[https://blog.sigplan.org/2020/01/14/what-is-a-sustainable-path-to-open-access/][the SIGPLAN blog in 2020]] \pause *** Open Data (much less painful story) + 1957-1958: International Geophysical Year shows the way\pause + 2006 (and 2021): OECD recommendation on [[https://www.oecd.org/sti/recommendation-access-to-research-data-from-public-funding.htm][publicly funded research data]]\pause + 2016 and later: FAIR terminology (/focus on metadata, sort of forgets open.../) * Compact version ** Software in the policy framework :PROPERTIES: :CUSTOM_ID: swpolicycompact :END: *** space :PROPERTIES: :BEAMER_env: ignoreheading :END: \vspace{-0.5em} *** [[https://en.unesco.org/foss/paris-call-software-source-code][Paris Call on Software Source code]] (2019, UNESCO) :B_picblock: :PROPERTIES: :BEAMER_env: picblock :BEAMER_OPT: pic=paris_call_ssc_cover.jpg, leftpic=true, width=.2\textwidth :END: [[https://en.unesco.org/news/experts-call-greater-recognition-software-source-code-heritage-sustainable-development][40 international experts call to]] #+LATEX: {\it “promote software development as a valuable research activity, and research software as a key enabler for Open Science/Open Research, [...] recognising in the careers of academics their contributions to high quality software development, in all their forms” #+LATEX: } *** spacepause :PROPERTIES: :BEAMER_env: ignoreheading :END: \vspace{-0.5em}\pause *** UNESCO [[https://unesdoc.unesco.org/ark:/48223/pf0000378381.locale=en][recommendations]] for Open Science, 2018-2021 /"The source code must be included in the software release and [...] the license must allow modifications, derivative works and sharing [...]"/ \\ /"Open science infrastructures should be [...] essentially not-for-profit and long-term"/ *** spacepause :PROPERTIES: :BEAMER_env: ignoreheading :END: \vspace{-0.5em}\pause *** [[https://data.europa.eu/doi/10.2777/28598][EOSC SIRS report]]: Software Source Code and Open Science, 2020 :B_picblock: :PROPERTIES: :BEAMER_env: picblock :BEAMER_OPT: pic=eosc-sirs-architecture-swh.png, leftpic=true, width=.3\textwidth :END: - *connect scholarly ecosystem via Software Heritage*\\ - use *open non profit* infrastructures\\ - *open source* first: /"all research software should be made available under an Open Source license by default"/ * END diff --git a/common/modules/swh-acquisition-process.org b/common/modules/swh-acquisition-process.org index 53c0393..03aba65 100644 --- a/common/modules/swh-acquisition-process.org +++ b/common/modules/swh-acquisition-process.org @@ -1,152 +1,188 @@ #+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 * SWHAP :PROPERTIES: :CUSTOM_ID: main :END: ** SWHAP: Software Heritage Acquisition Process \hfill /\href{https://unesdoc.unesco.org/ark:/48223/pf0000371017}{Guide}/ :PROPERTIES: :CUSTOM_ID: swhap :END: *** Paris Call on Software Source Code “[We call to] support efforts to gather and preserve the artifacts and narratives of the history of computing, while the earlier creators are still alive” #+BEAMER: \pause *** :B_block:BMCOL: :PROPERTIES: :BEAMER_col: 0.3 :END: #+BEGIN_EXPORT latex \begin{center} \includegraphics[width=\extblockscale{1.3\linewidth}]{SWHAP-cover.pdf} \end{center} #+END_EXPORT #+BEAMER: \pause *** :B_block:BMCOL: :PROPERTIES: :BEAMER_col: 0.7 :END: - **Rescue** Legacy Software from different media - physical - digital - legacy / unsupported - recent / supported #+BEAMER: \pause - **Curate** the code - reconstructing the development history - collecting metadata #+BEAMER: \pause - And **illustrate** with dedicated presentations ** SWHAP: Four phases workflow to streamline the effort :PROPERTIES: :CUSTOM_ID: swhapphases :END: #+BEGIN_EXPORT latex \begin{center} \includegraphics[width=\extblockscale{1.4\linewidth}]{SWHAP-diagram.png} \end{center} #+END_EXPORT ** SWH@PISA finds : TAUmus (‘70s) :PROPERTIES: :CUSTOM_ID: swhaptaumus :END: *** Electronic music in Pisa: group led by the late M° P. Grossi :PROPERTIES: :BEAMER_env: picblock :BEAMER_OPT: pic=TAUmus-cropped.png, leftpic=true, width=.6\linewidth :END: \vspace{-2em} - Control code of the music synthesizer TAU2 - FORTRAN II, TAUmus command language - Istituto di Elaborazione dell'Informazione CNR - e.g. \href{https://www.youtube.com/watch?v=ipvcWHNGTUw}{Le Sacre du Printemps (ABSTRACT)} *** See this live - [[https://archive.softwareheritage.org/swh:1:dir:4506b195bbfadeffe37b79bcdc11939879da2dd8;origin=https://github.com/Unipisa/TAUmus;visit=swh:1:snp:5c9eaa6886ffe0fa1299682982b3dd5201b8d452;anchor=swh:1:rev:3e4e117c5eabad1a5cc1b87918b399d433b2a2e8][the archived SWHAP repository]] - and [[https://swh.stories.k2.services/stories/Q107316563][its Software Story]] ** SWHAP@PISA: Capturing metadata in branch master :PROPERTIES: :CUSTOM_ID: masterbranch :END: #+BEGIN_EXPORT latex \begin{center} \includegraphics[width=\extblockscale{1.2\linewidth}]{TAUmus-on-GitHub.png} \end{center} #+END_EXPORT ** SWHAP@PISA: Recreating development history in branch SourceCode :PROPERTIES: :CUSTOM_ID: sourcecodebranch :END: #+BEGIN_EXPORT latex \begin{center} \includegraphics[width=\extblockscale{1.2\linewidth}]{TAUmus-SourceCode-branch.png} \end{center} #+END_EXPORT ** SWHAP@PISA: Archiving source code with Save Code Now :PROPERTIES: :CUSTOM_ID: savecodenow :END: #+latex: \begin{center} #+ATTR_LATEX: :width \linewidth file:webui-save-code-now.png #+latex: \end{center} ** SWHAP@PISA: Referencing source code on SWH :PROPERTIES: :CUSTOM_ID: onswh :END: #+BEGIN_EXPORT latex \begin{center} \includegraphics[width=\extblockscale{1.5\linewidth}]{TAUmus-on-SWH.png} \end{center} #+END_EXPORT * Software Stories ** Software Stories \hfill /\href{https://hal.archives-ouvertes.fr/hal-03483982}{Guide}/ :PROPERTIES: :CUSTOM_ID: stories :END: *** Paris Call on Software Source Code “[We call to] support efforts to gather and preserve the artifacts *and narratives* of the history of computing, while the earlier creators are still alive” #+BEAMER: \pause *** :B_block:BMCOL: :PROPERTIES: :BEAMER_col: 0.3 :END: #+BEGIN_EXPORT latex \begin{center} \includegraphics[width=\extblockscale{1.35\linewidth}]{swhstories.png} \end{center} #+END_EXPORT #+BEAMER: \pause *** :B_block:BMCOL: :PROPERTIES: :BEAMER_col: 0.7 :END: - **Expand** the SWHAP scope to + documents + media (videos, pictures, images, etc.) + oral history #+BEAMER: \pause - **Preserve and Present** all this material #+BEAMER: \pause - **Share** process and tools (all open source!) + with museums, archives and all interested parties #+BEAMER: \pause \hfill see this live on [[https://stories.softwareheritage.org][the Software Stories website]], and get /\href{https://hal.archives-ouvertes.fr/hal-03483982}{the guide}/ - +** Meet the team + :PROPERTIES: + :CUSTOM_ID: team + :END: +*** :B_column: + :PROPERTIES: + :BEAMER_env: column + :BEAMER_COL: .33 + :END: +#+ATTR_LATEX: :width .9\linewidth +file:stories/LB.png +#+ATTR_LATEX: :width .9\linewidth +file:stories/RDC.png +#+ATTR_LATEX: :width .9\linewidth +file:stories/MG.png +*** :B_column: + :PROPERTIES: + :BEAMER_env: column + :BEAMER_COL: .33 + :END: +#+ATTR_LATEX: :width .9\linewidth +file:stories/CM.png +#+ATTR_LATEX: :width .9\linewidth +file:stories/EM.png +#+ATTR_LATEX: :width .9\linewidth +file:stories/GS.png +*** :B_column: + :PROPERTIES: + :BEAMER_env: column + :BEAMER_COL: .33 + :END: +#+ATTR_LATEX: :width .9\linewidth +file:stories/KSN.png +#+ATTR_LATEX: :width .9\linewidth +file:stories/KT.png +#+ATTR_LATEX: :width .9\linewidth +file:stories/placeholder.png diff --git a/common/modules/swh-scientific-preservation.org b/common/modules/swh-scientific-preservation.org index 2c34b13..7df5220 100644 --- a/common/modules/swh-scientific-preservation.org +++ b/common/modules/swh-scientific-preservation.org @@ -1,95 +1,94 @@ #+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 * Software Heritage for Scientific Publishing :PROPERTIES: :CUSTOM_ID: main :END: ** Save and reference research software \hfill \href{https://www.softwareheritage.org/save-and-reference-research-software/}{SWH guidelines} :PROPERTIES: :CUSTOM_ID: prepare :END: *** Prepare your public repository with: :B_picblock: - README, LICENSE, AUTHORS & codemeta.json files #+LATEX: \pause *** What's a good README \hfill extracted from \href{https://www.tldp.org/HOWTO/html_single/Software-Release-Practice-HOWTO/}{Eric Steven Raymond} and \href{https://www.makeareadme.com/}{Make a README} /MUST/ include: - **Name** and a **description** of the software. #+BEAMER: \pause /SHOULD/ include: - how to **run** and **use** the source code - build **environment**, installation, requirements #+BEAMER: \pause /CAN/ include: - project **website** or **documentation** pointer and recent **news** - **visuals** - ** Save and reference research software \hfill \href{https://www.softwareheritage.org/save-and-reference-research-software/}{SWH guidelines} :PROPERTIES: :CUSTOM_ID: save :END: *** Save code now on \hfill \url{https://archive.softwareheritage.org/save/} - git, svn or mercurial - intrinsic metadata files - complete history #+latex: \begin{center} #+ATTR_LATEX: :width \linewidth file:webui-save-code-now.png #+latex: \end{center} ** Save and reference research software \hfill \href{https://www.softwareheritage.org/save-and-reference-research-software/}{SWH guidelines} :PROPERTIES: :CUSTOM_ID: reference :END: Choose the granularity level for the reference: #+BEAMER: \pause *** file (with code fragment) #+BEGIN_EXPORT latex \begin{tcolorbox} \href{https://archive.softwareheritage.org/swh:1:cnt:c60366bc03936eede6509b23307321faf1035e23;lines=473-537;origin=https://github.com/sagemath/sage/} {swh:1:{\bf cnt}:c60366bc03936eede6509b23307321faf1035e23;lines=473-537}\\ \mbox{} \hfill ... and add {\it ;origin=https://github.com/sagemath/sage/} \end{tcolorbox} \hfill James McCaffrey's {\bf algorithm} in sageMath #+END_EXPORT #+BEAMER: \pause *** directory #+BEGIN_EXPORT latex \begin{tcolorbox} \href{https://archive.softwareheritage.org/swh:1:dir:c6f07c2173a458d098de45d4c459a8f1916d900f;origin=https://github.com/id-Software/Quake-III-Arena/} {swh:1:{\bf dir}:c6f07c2173a458d098de45d4c459a8f1916d900f}\\ \mbox{}\hfill ... and add {\it ;origin=https://github.com/id-Software/Quake-III-Arena/} \end{tcolorbox} \hfill source code of {\bf Quake-III Arena} from id-Software #+END_EXPORT ** Save and reference research software \hfill \href{https://www.softwareheritage.org/save-and-reference-research-software/}{SWH guidelines} :PROPERTIES: :CUSTOM_ID: referencecontd :END: *** specific release #+BEGIN_EXPORT latex \begin{tcolorbox} \href{https://archive.softwareheritage.org/swh:1:rel:22ece559cc7cc2364edc5e5593d63ae8bd229f9f;origin=https://github.com/darktable-org/darktable/} {swh:1:{\bf rel}:22ece559cc7cc2364edc5e5593d63ae8bd229f9f}\\ \mbox{}\hfill ... and add {\it ;origin=https://github.com/darktable-org/darktable/} \end{tcolorbox} \hfill {\bf release} 2.3.0 of Darktable, dated 24 December 2016 #+END_EXPORT #+BEAMER: \pause *** full snapshot (including all branches and all releases) #+BEGIN_EXPORT latex \begin{tcolorbox} \href{https://archive.softwareheritage.org/swh:1:snp:c7c108084bc0bf3d81436bf980b46e98bd338453;origin=https://github.com/darktable-org/darktable/} {swh:1:{\bf snp}:c7c108084bc0bf3d81436bf980b46e98bd338453}\\ \mbox{}\hfill ... and add {\it ;origin=https://github.com/darktable-org/darktable/} \end{tcolorbox} \hfill a {\bf snapshot} of the entire Darktable repository (4 May 2017, GitHub) #+END_EXPORT