Merge remote-tracking branch 'upstream/master' into shellfish

Author: hugovk

.github/workflows/test.yml

@@ -1,23 +1,23 @@
 name: Test
 
-on: [push, pull_request]
+on: [push, pull_request, workflow_dispatch]
 
 jobs:
   test:
-    runs-on: ubuntu-18.04
+    runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
 
       - name: Set up node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v3
         with:
           python-version: '10.x'
 
       - name: Set up Python
-        uses: actions/setup-python@v1
+        uses: actions/setup-python@v4
         with:
-          python-version: '3.8'
+          python-version: '3.x'
 
       - name: Install dependencies
         run: |

README.md

@@ -20,7 +20,7 @@ This project is not meant to replace exhaustive APIs -- if you want nouns, and y
 
 ## What is Corpora?
 
- * Corpora is repository of JSON files, meant to be language-neutral. If you want to create an NPM repo or whatever based on this, be my guest, but this repository will remain a collection of data files that can be interpreted by any language that can parse JSON.
+ * Corpora is a repository of JSON files, meant to be language-neutral. If you want to create an NPM repo or whatever based on this, be my guest, but this repository will remain a collection of data files that can be interpreted by any language that can parse JSON.
  * Corpora is a collection of _small_ files. It is not meant to be an exhaustive source of anything: a list of resources should contain somewhere in the vicinity of 1000 items.
    * For example, Corpora will not contain any complete "dictionary" style files. Instead we host a sampling of 1000 common nouns, adjectives, and verbs.
    * Some lists are small enough by nature that we may contain a complete list of things in their category. For example, a list of heavily populated U.S. cities may only have 75 cities and be considered complete.
@@ -29,7 +29,7 @@ This project is not meant to replace exhaustive APIs -- if you want nouns, and y
 
  * [corpora-project](https://www.npmjs.com/package/corpora-project), a Node.js NPM package for accessing corpora data offline.
  * [pycorpora](https://github.com/aparrish/pycorpora), a simple Python interface for corpora
- * [corpora-api](https://github.com/coleww/corpora-api), a Node.js server that offers up the corpora as a JSON API
+ * [corpora-api](https://github.com/coleww/corpora-api), a Node.js server that offers up the corpora as a JSON API (now live at <https://corpora-api.glitch.me>)
 
 ## I have some data, how do I submit?
 

data/animals/cats.json

@@ -1,4 +1,5 @@
 {
+   "description": "A list of cat breeds",
    "cats":[
       "Abyssinian",
       "Aegean",
@@ -97,4 +98,4 @@
       "Turkish Van",
       "Ukrainian Levkoy"
    ]
-}
+}

data/animals/common.json

@@ -1,4 +1,5 @@
 {
+  "description": "A list of common types of animals",
   "animals":
     [
       "aardvark",