Merge pull request #75 from bact/add-crosswalk-intro

moranegg · web-flow · commit a802fb8cae5f · 2025-10-06T17:13:48.000+02:00
Add missing crosswalk intros
diff --git a/content/crosswalk/datacite.md b/content/crosswalk/datacite.md
@@ -2,10 +2,8 @@
 title: "Crosswalk for DataCite metadata"
 image: "/img/datacite.png"
 date: "2017-06-01"
-
 ---
 
-<img src="/img/datacite.png" width="400" />
-
+[DataCite](https://datacite.org/) metadata is a standardized set of schema used when registering a DOI to ensure research outputs are findable, citable, and connected within the global scholarly ecosystem.
 
 {{< crosswalk name="DataCite" >}}
diff --git a/content/crosswalk/debian.md b/content/crosswalk/debian.md
@@ -2,9 +2,8 @@
 title: "Crosswalk for Debian packages"
 image: "/img/debian.png"
 date: "2017-06-01"
-
 ---
 
-The [Debian package system](https://www.debian.org/doc/manuals/debian-reference/ch02.en.html#_archive_meta_data) defines archive metadata that is used by the popular `apt` package management system on Debian and Ubuntu Linux distributions.  
+The [Debian package system](https://www.debian.org/doc/manuals/debian-reference/ch02.en.html#_archive_meta_data) defines archive metadata that is used by the popular [`apt`](https://wiki.debian.org/Apt) package management system on Debian and Ubuntu Linux distributions.
 
 {{< crosswalk name="Debian Package" >}}
diff --git a/content/crosswalk/doap.md b/content/crosswalk/doap.md
@@ -6,5 +6,4 @@ date: "2017-06-01"
 
 [DOAP](https://github.com/ewilderj/doap) (Description of a Project) is an XML/RDF vocabulary to describe software projects, and in particular open source projects.
 
-
 {{< crosswalk name="DOAP" >}}
diff --git a/content/crosswalk/dublincore.md b/content/crosswalk/dublincore.md
@@ -3,5 +3,6 @@ title: "Crosswalk for Dublin Core metadata"
 image: "/img/dcmi.png"
 ---
 
+[Dublin Core](https://www.dublincore.org/) vocabulary (or the Dublin Core Metadata Terms - DCMT) is a widely used, general-purpose metadata vocabulary for describing any type of resource.
 
 {{< crosswalk name="Dublin Core" >}}
diff --git a/content/crosswalk/figshare.md b/content/crosswalk/figshare.md
@@ -3,7 +3,6 @@ title: "Crosswalk for figshare metadata"
 image: "/img/figshare.jpg"
 ---
 
-[figshare](https://figshare.com) is a general purpose scientific data repository that provides DataCite DOIs.
-
+[figshare](https://figshare.com) is a general purpose scientific data repository that provides [DataCite](https://datacite.org/) DOIs.
 
 {{< crosswalk name="Figshare" >}}
diff --git a/content/crosswalk/github.md b/content/crosswalk/github.md
@@ -4,6 +4,8 @@ image: "/img/github.png"
 date: "2017-06-01"
 ---
 
+[GitHub](https://github.com/) is a widely-used proprietary developer platform that allows users to store, manage, and share code using Git for distributed version control.
 
+[GitHub API](https://docs.github.com/en/rest) provides a programmatic way to retrieve repository metadata.
 
 {{< crosswalk name="GitHub" >}}
diff --git a/content/crosswalk/java.md b/content/crosswalk/java.md
@@ -2,10 +2,8 @@
 title: "Crosswalk for Java's Maven metadata"
 image: "/img/java.png"
 date: "2017-06-01"
-
 ---
 
 [Maven](https://maven.apache.org/what-is-maven.html) is a popular packaging/build system for Java-based projects.
 
-
 {{< crosswalk name="Java (Maven)" >}}
diff --git a/content/crosswalk/node.md b/content/crosswalk/node.md
@@ -1,10 +1,11 @@
 ---
-title: "Crosswalk for NodeJS package.json"
+title: "Crosswalk for Node.js package.json"
 image: "/img/npm.png"
 date: "2017-06-01"
 ---
 
-The `npm` package manager for NodeJS [defines](https://docs.npmjs.com/files/package.json) software metadata using a `package.json` file. 
+The `npm` package manager for JavaScript [defines](https://docs.npmjs.com/files/package.json) software metadata using a `package.json` file.
 
+`npm` is the default package manager for the JavaScript runtime environment Node.js.
 
 {{< crosswalk name="NodeJS" >}}
diff --git a/content/crosswalk/publiccode.md b/content/crosswalk/publiccode.md
@@ -2,7 +2,6 @@
 title: "Crosswalk for publiccode.yml"
 image: "/img/publiccode.png"
 date: "2025-08-10"
-
 ---
 
 The [publiccode.yml](https://github.com/publiccodeyml/publiccode.yml) spec defines metadata for public sector OSS software projects, used by national and international catalogs to index, present, and facilitate the reuse of open source software developed by or for public administrations.
diff --git a/content/crosswalk/python.md b/content/crosswalk/python.md
@@ -2,10 +2,8 @@
 title: "Crosswalk for Python distutils"
 image: "/img/python.png"
 date: "2017-06-01"
-
 ---
 
-[Python `distutils`](https://docs.python.org/3.6/distutils/) allows users to associate a range of metadata information when packaging and distributing python-based applications or source code.  
-
+[Python `distutils`](https://docs.python.org/3.6/distutils/) allows users to associate a range of metadata information when packaging and distributing Python-based applications or source code.  
 
 {{< crosswalk name="Python Distutils (PyPI)" >}}
diff --git a/content/crosswalk/ruby.md b/content/crosswalk/ruby.md
@@ -2,10 +2,8 @@
 title: "Crosswalk for Ruby gems"
 image: "/img/ruby.png"
 date: "2017-06-01"
-
 ---
 
 Ruby gems [specify metadata](http://guides.rubygems.org/specification-reference/) in a `.gemspec` file.
 
-
 {{< crosswalk name="Ruby Gem" >}}
diff --git a/content/crosswalk/swo.md b/content/crosswalk/swo.md
@@ -4,7 +4,8 @@ image: "/img/swo.png"
 date: "2017-01-05"
 ---
 
-The [Software Ontology (SWO)](http://theswo.sourceforge.net/) is a resource for describing software tools, their types, tasks, versions, provenance and data associated. SWO is part of the JISC funded SWORD project (Software Ontology for Resource Description), an inter-disciplinary effort to capture software descriptions used in the preservation of data. The work is a collaboration between the European Bioinformatics Institute and the University of Manchester.
-
+The [Software Ontology (SWO)](http://theswo.sourceforge.net/) is a resource for describing software tools, their types, tasks, versions, provenance and data associated.
+SWO is part of the JISC funded [SWORD project](https://www.software.ac.uk/blog/sword-software-ontology-research-description) (Software Ontology for Resource Description), an inter-disciplinary effort to capture software descriptions used in the preservation of data.
+The work is a collaboration between the European Bioinformatics Institute and the University of Manchester.
 
 {{< crosswalk name="Software Ontology" >}}
diff --git a/content/crosswalk/trove.md b/content/crosswalk/trove.md
@@ -3,6 +3,6 @@ title: "Crosswalk for Trove Software Map"
 image: "/img/sourceforge.png"
 ---
 
-[Trove Software Map](https://sourceforge.net/p/easyhtml5/tracinst/Software%20Map%20and%20Trove/#what-is-trove). Trove is the system used by SourceForge.net to classify software projects.
+[Trove](https://web.archive.org/web/20240420104333/https://sourceforge.net/p/easyhtml5/tracinst/Software%20Map%20and%20Trove/#what-is-trove) is the system used by [SourceForge.net](https://sourceforge.net/) software development hosting platform to classify software projects.
 
 {{< crosswalk name="Trove Software Map" >}}
diff --git a/content/crosswalk/wikidata.md b/content/crosswalk/wikidata.md
@@ -2,10 +2,11 @@
 title: "Crosswalk for WikiData Properties"
 image: "/img/wikidata.png"
 date: "2017-06-04"
-
 ---
 
-[Wikidata](https://www.wikidata.org/wiki/Wikidata:Introduction)  provides internationalized set of properties for machine-readable linked data.  (Surprisingly wikidata does not have a native JSON-LD format, [distributing in plain json](https://www.wikidata.org/wiki/Wikidata:Database_download).)
+[Wikidata](https://www.wikidata.org/wiki/Wikidata:Introduction) provides internationalized set of properties for machine-readable linked data.
 
+Surprisingly Wikidata does not have a native JSON-LD format,
+[distributing in plain JSON and RDF dumps](https://www.wikidata.org/wiki/Wikidata:Database_download).
 
 {{< crosswalk name="Wikidata" >}}
diff --git a/content/crosswalk/zenodo.md b/content/crosswalk/zenodo.md
@@ -3,9 +3,6 @@ title: "Crosswalk for Zenodo metadata"
 image: "/img/zenodo.jpg"
 ---
 
-
-
 [Zenodo.org](https://zenodo.org) is a data archive based at CERN which is popularly used to archive and provide DOIs to academic software from GitHub, as described in the official GitHub guide to [Making your code citable](https://guides.github.com/activities/citable-code/).
 
-
 {{< crosswalk name="Zenodo" >}}
diff --git a/content/user-guide.md b/content/user-guide.md
@@ -1,5 +1,5 @@
 ---
-title: User guide
+title: User Guide
 ---
 
 ## Generating a CodeMeta file

Original file line number	Diff line number	Diff line change
`@@ -6,5 +6,4 @@ date: "2017-06-01"`
`6`	`6`
`7`	`7`	`[DOAP](https://github.com/ewilderj/doap) (Description of a Project) is an XML/RDF vocabulary to describe software projects, and in particular open source projects.`
`8`	`8`
`9`		`-`
`10`	`9`	`{{< crosswalk name="DOAP" >}}`