Add bibliography submodule

.github/workflows/compile.yml

@@ -8,6 +8,8 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          submodules: 'recursive'
       - name: Install pandoc
         run: |
           sudo apt-get update && sudo apt-get install -y --no-install-recommends \

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "bibliography"]
+	path = bibliography
+	url = [email protected]:the-teachingRSE-project/bibliography.git

Makefile

@@ -6,12 +6,12 @@ objects := competencies.pdf
 
 all: $(objects)
 
-%.pdf: %.md bibliography.bib contributors.yml preamble.sty build/template.tex glossary.tex filter.py
+%.pdf: %.md bibliography/bibliography.bib contributors.yml preamble.sty build/template.tex glossary.tex filter.py
 	@mkdir -p build
 	@mkdir -p build/svg-inkscape
 	@rm -f build/pdfa.xmpi
 	cp --update preamble.sty build/
-	cp --update bibliography.bib build/
+	cp --update bibliography/bibliography.bib build/
 	cp --update glossary.tex build/
 	python3 filter.py --input="${<}" --output="build/${<}" --contributors="contributors.yml"
 	pandoc \

README.md

@@ -45,9 +45,18 @@ You will also need to install a few Python packages:
 python3 -m pip install -r requirements.txt
 ```
 
+### Bibliography
+
+We use a single, shared BibTeX bibliography file for all papers in the teaching RSE project. This is imported as a Git submodule from [another repository](https://github.com/the-teachingRSE-project/bibliography). See the instructions in that repository if you need to add bibliography entries.
+
 ### How to create a pull request
 
 - Fork this repository
+- run
+  ```sh
+  git submodule update --init --recursive
+  git config --local submodule.recurse true
+  ```
 - Create your changes in your fork
 - Go to the [pull requests](https://github.com/CaptainSifff/paper_teaching-learning-RSE/pulls) page of this repository and push `new pull request`
 - You can add DRAFT, or WIP to indicate work-in-progress PRs.