diff --git a/.gitignore b/.gitignore
index ef6694446623963732d99eb5eb2984e935bf4b22..4e6b9138cdcfd43b1cc7a55093755374c64de0f3 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,3 +4,7 @@
 *.log
 
 /*.pdf
+
+# files that are usually excluded but here we want them:
+!example.pdf
+!.vscode/*.json
diff --git a/.vscode/extensions.json b/.vscode/extensions.json
new file mode 100644
index 0000000000000000000000000000000000000000..c1b31c630a33d2bbe9d8020c33eaf611e5038aa8
--- /dev/null
+++ b/.vscode/extensions.json
@@ -0,0 +1,7 @@
+{
+	"recommendations": [
+		"james-yu.latex-workshop",
+		"valentjn.vscode-ltex",
+		"stkb.rewrap"
+	]
+}
diff --git a/.vscode/settings.json b/.vscode/settings.json
new file mode 100644
index 0000000000000000000000000000000000000000..64b3899e183f8ba0c8cd68f4c71584f909c0c61f
--- /dev/null
+++ b/.vscode/settings.json
@@ -0,0 +1,123 @@
+{
+	"ltex.enabled": true,
+	"ltex.language": "en-GB",
+	"ltex.additionalRules.motherTongue": "de-DE",
+	"[latex]": {
+		"rewrap.autoWrap.enabled": true,
+		"editor.rulers": [
+			100
+		],
+		"rewrap.wrappingColumn": 100,
+	},
+	"latex-workshop.linting.run": "onType",
+	"latex-workshop.latex.autoBuild.run": "onSave",
+	"latex-workshop.showContextMenu": true,
+	"latex-workshop.latex.outDir": "%DIR%",
+	"latex-workshop.latex.recipes": [
+		{
+			"name": "latexmk",
+			"tools": [
+				"latexmk"
+			]
+		},
+		{
+			"name": "pdflatex",
+			"tools": [
+				"pdflatex"
+			]
+		},
+		{
+			"name": "biber",
+			"tools": [
+				"biber"
+			]
+		},
+		{
+			"name": "pdflatex ➞ biber ➞ 2× pdflatex",
+			"tools": [
+				"pdflatex",
+				"biber",
+				"pdflatex",
+				"pdflatex"
+			]
+		},
+		{
+			"name": "Optimize PDF",
+			"tools": [
+				"gs opt printer"
+			]
+		}
+	],
+	"latex-workshop.latex.tools": [
+		{
+			"name": "latexmk",
+			"command": "latexmk",
+			"args": [
+				"-pdf",
+				"-interaction=nonstopmode",
+				"-synctex=1",
+				"-auxdir=%OUTDIR%/.aux",
+				"-outdir=%OUTDIR%",
+				"%DOC_EXT%"
+			],
+			"env": {
+				"TEXINPUTS": "%WORKSPACE_FOLDER%/src/"
+			}
+		},
+		{
+			"name": "pdflatex",
+			"command": "pdflatex",
+			"args": [
+				"-synctex=1",
+				"-interaction=nonstopmode",
+				"-file-line-error",
+				"-aux-directory=%OUTDIR%/.aux",
+				"-output-directory=%OUTDIR%",
+				"%DOC_EXT%"
+			],
+			"env": {
+				"TEXINPUTS": "%WORKSPACE_FOLDER%/src/"
+			}
+		},
+		{
+			"name": "biber",
+			"command": "biber",
+			"args": [
+				"-output-directory=%OUTDIR%/.aux",
+				"%DOCFILE%"
+			]
+		},
+		{
+			"name": "bibtex",
+			"command": "bibtex",
+			"args": [
+				"-include-directory=.aux",
+				"%OUTDIR%/.aux/%DOCFILE%"
+			]
+		},
+		{
+			"name": "gs opt printer",
+			"command": "mgs",
+			"args": [
+				"-sDEVICE=pdfwrite",
+				"-dPrinted=false",
+				"-dPDFSETTINGS=/printer",
+				"-o",
+				"%OUTDIR%/%DOCFILE%_optimized.pdf",
+				"%OUTDIR%/%DOCFILE%.pdf"
+			]
+		},
+		{
+			"name": "gs opt extrem",
+			"command": "mgs",
+			"args": [
+				"-sDEVICE=pdfwrite",
+				"-dPrinted=false",
+				"-dPDFSETTINGS=/ebook",
+				"-o",
+				"%OUTDIR%/%DOCFILE%_optimized.pdf",
+				"%OUTDIR%/%DOCFILE%.pdf"
+			]
+		}
+	],
+}
diff --git a/example.pdf b/example.pdf
index 51f2aee08b7c75fb2e1577c3cab7b02437a1ff6a..877e10f9602c2da8db3e445104d4aeb2a80242cc 100644
--- a/example.pdf
+++ b/example.pdf
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:9ae99708e9128d305fb6d9af123778381dbb1726d8ca998da3c818c18abc9188
-size 257485
+oid sha256:3129c59bf8c34cd5cd6c75f66909d541da45d87b49f355f24102f1a8c98cf980
+size 257486