citation documentation + delete CITATION.cff files

docs/about/about.md

@@ -8,10 +8,20 @@ jsPsych was created by [Josh de Leeuw](https://www.vassar.edu/faculty/jdeleeuw).
 
 If you use this library in academic work, the preferred citation is:
 
-de Leeuw, J.R., Gilbert, R.A., & Luchterhandt, B. (2023). jsPsych: Enabling an open-source collaborative ecosystem of behavioral experiments. *Journal of Open Source Software*, *8*(85), 5351, [https://joss.theoj.org/papers/10.21105/joss.05351](https://joss.theoj.org/papers/10.21105/joss.05351).
+> de Leeuw, J.R., Gilbert, R.A., & Luchterhandt, B. (2023). jsPsych: Enabling an open-source collaborative ecosystem of behavioral experiments. *Journal of Open Source Software*, *8*(85), 5351, [https://joss.theoj.org/papers/10.21105/joss.05351](https://joss.theoj.org/papers/10.21105/joss.05351).
 
 This paper is an updated description of jsPsych and includes all current core team members. It replaces the earlier paper that described jsPsych:
 
-de Leeuw, J.R. (2015). jsPsych: A JavaScript library for creating behavioral experiments in a Web browser. *Behavior Research Methods*, _47_(1), 1-12. doi:[10.3758/s13428-014-0458-y](http://link.springer.com/article/10.3758%2Fs13428-014-0458-y)
+> de Leeuw, J.R. (2015). jsPsych: A JavaScript library for creating behavioral experiments in a Web browser. *Behavior Research Methods*, _47_(1), 1-12. doi:[10.3758/s13428-014-0458-y](http://link.springer.com/article/10.3758%2Fs13428-014-0458-y)
 
 Citations help us demonstrate that this library is used and valued, which allows us to continue working on it.
+
+#### Cite using citation tool
+
+We also made a command-line citation tool that can be used to cite this library, as well as any plugins/extensions you use in your experiment that are developed by other developers. You can see this tool in action by following these steps:
+
+1. Launch a jsPsych experiment in your browser
+2. Open up the browser console using Ctrl + ⇧ + J (Windows) or ⌘ + ⌥ + J (Mac)
+3. Type `jsPsych.getCitations([jsPsychHtmlKeyboardResponse], "apa")`
+
+This should print the APA format citation for the `jsPsychHtmlKeyboardResponse` plugin, which you can then copy and paste into your working document. You can type any number of plugins/extensions by name in the array `[ ]` to generate a list of citations. We currently support APA formatting (`"apa"`) and BibTex formatting (`"bibtex"`).

docs/developers/contributing.md

@@ -20,6 +20,8 @@ We welcome contributions of any scope. Before we can merge changes into the main
 
 * **An example file should be included if applicable.** If you are contributing a new feature, new plugin, or new extension, or contributing a modification that changes the behavior of the library in some important way, consider adding an example file to the `/examples` folder in the repository.
 
+* **We strongly encourage including a file containing citation information.** This file should be named `CITATION.cff` and placed at the root of your repository. This allows people who use your plugin/extension in their code to easily cite your work by calling `jsPsych.getCitations([<yourPlugin>])` from their command line. More information on `.cff` files can be found [here](https://citation-file-format.github.io/).
+
 * **A changeset must be included in the pull request**. We use [changesets](https://github.com/atlassian/changesets/blob/main/docs/adding-a-changeset.md) to generate new releases and their corresponding release notes. [This is a good overview of changesets](https://github.com/atlassian/changesets/blob/main/docs/adding-a-changeset.md) that explains how to add one to your pull request. Feel free to ask for help with this!
 
 * **Update the contributors.md file**. If you are a first time contributor to jsPsych please add your name to our [contributors file](https://github.com/jspsych/jsPsych/blob/main/contributors.md). And thanks!

packages/extension-mouse-tracking/CITATION.cff

@@ -1,47 +0,0 @@
-cff-version: "1.2.0"
-authors:
-- family-names: Leeuw
-  given-names: Joshua R.
-  name-particle: de
-  orcid: "https://orcid.org/0000-0003-4815-2364"
-- family-names: Gilbert
-  given-names: Rebecca A.
-  orcid: "https://orcid.org/0000-0003-4574-7792"
-- family-names: Luchterhandt
-  given-names: Björn
-  orcid: "https://orcid.org/0000-0002-9225-2787"
-contact:
-- family-names: Leeuw
-  given-names: Joshua R.
-  name-particle: de
-  orcid: "https://orcid.org/0000-0003-4815-2364"
-doi: 10.5281/zenodo.7702307
-message: If you use this software, please cite our article in the
-  Journal of Open Source Software.
-preferred-citation:
-  authors:
-  - family-names: Leeuw
-    given-names: Joshua R.
-    name-particle: de
-    orcid: "https://orcid.org/0000-0003-4815-2364"
-  - family-names: Gilbert
-    given-names: Rebecca A.
-    orcid: "https://orcid.org/0000-0003-4574-7792"
-  - family-names: Luchterhandt
-    given-names: Björn
-    orcid: "https://orcid.org/0000-0002-9225-2787"
-  date-published: 2023-05-11
-  doi: 10.21105/joss.05351
-  issn: 2475-9066
-  issue: 85
-  journal: Journal of Open Source Software
-  publisher:
-    name: Open Journals
-  start: 5351
-  title: "jsPsych: Enabling an Open-Source Collaborative Ecosystem of
-    Behavioral Experiments"
-  type: article
-  url: "https://joss.theoj.org/papers/10.21105/joss.05351"
-  volume: 8
-title: "jsPsych: Enabling an Open-Source Collaborative Ecosystem of
-  Behavioral Experiments"

packages/plugin-html-keyboard-response/CITATION.cff

@@ -1,47 +0,0 @@
-cff-version: "1.2.0"
-authors:
-- family-names: Leeuw
-  given-names: Joshua R.
-  name-particle: de
-  orcid: "https://orcid.org/0000-0003-4815-2364"
-- family-names: Gilbert
-  given-names: Rebecca A.
-  orcid: "https://orcid.org/0000-0003-4574-7792"
-- family-names: Luchterhandt
-  given-names: Björn
-  orcid: "https://orcid.org/0000-0002-9225-2787"
-contact:
-- family-names: Leeuw
-  given-names: Joshua R.
-  name-particle: de
-  orcid: "https://orcid.org/0000-0003-4815-2364"
-doi: 10.5281/zenodo.7702307
-message: If you use this software, please cite our article in the
-  Journal of Open Source Software.
-preferred-citation:
-  authors:
-  - family-names: Leeuw
-    given-names: Joshua R.
-    name-particle: de
-    orcid: "https://orcid.org/0000-0003-4815-2364"
-  - family-names: Gilbert
-    given-names: Rebecca A.
-    orcid: "https://orcid.org/0000-0003-4574-7792"
-  - family-names: Luchterhandt
-    given-names: Björn
-    orcid: "https://orcid.org/0000-0002-9225-2787"
-  date-published: 2023-05-11
-  doi: 10.21105/joss.05351
-  issn: 2475-9066
-  issue: 85
-  journal: Journal of Open Source Software
-  publisher:
-    name: Open Journals
-  start: 5351
-  title: "jsPsych: Enabling an Open-Source Collaborative Ecosystem of
-    Behavioral Experiments"
-  type: article
-  url: "https://joss.theoj.org/papers/10.21105/joss.05351"
-  volume: 8
-title: "jsPsych: Enabling an Open-Source Collaborative Ecosystem of
-  Behavioral Experiments"

packages/plugin-preload/CITATION.cff

@@ -1,47 +0,0 @@
-cff-version: "1.2.0"
-authors:
-- family-names: Leeuw
-  given-names: Joshua R.
-  name-particle: de
-  orcid: "https://orcid.org/0000-0003-4815-2364"
-- family-names: Gilbert
-  given-names: Rebecca A.
-  orcid: "https://orcid.org/0000-0003-4574-7792"
-- family-names: Luchterhandt
-  given-names: Björn
-  orcid: "https://orcid.org/0000-0002-9225-2787"
-contact:
-- family-names: Leeuw
-  given-names: Joshua R.
-  name-particle: de
-  orcid: "https://orcid.org/0000-0003-4815-2364"
-doi: 10.5281/zenodo.7702307
-message: If you use this software, please cite our article in the
-  Journal of Open Source Software.
-preferred-citation:
-  authors:
-  - family-names: Leeuw
-    given-names: Joshua R.
-    name-particle: de
-    orcid: "https://orcid.org/0000-0003-4815-2364"
-  - family-names: Gilbert
-    given-names: Rebecca A.
-    orcid: "https://orcid.org/0000-0003-4574-7792"
-  - family-names: Luchterhandt
-    given-names: Björn
-    orcid: "https://orcid.org/0000-0002-9225-2787"
-  date-published: 2023-05-11
-  doi: 10.21105/joss.05351
-  issn: 2475-9066
-  issue: 85
-  journal: Journal of Open Source Software
-  publisher:
-    name: Open Journals
-  start: 5351
-  title: "jsPsych: Enabling an Open-Source Collaborative Ecosystem of
-    Behavioral Experiments"
-  type: article
-  url: "https://joss.theoj.org/papers/10.21105/joss.05351"
-  volume: 8
-title: "jsPsych: Enabling an Open-Source Collaborative Ecosystem of
-  Behavioral Experiments"