From ce495dfbfd3eaecb84b3c536ad2176a7249d5b19 Mon Sep 17 00:00:00 2001
From: Loek Le Blansch <loek@pipeframe.xyz>
Date: Thu, 5 Sep 2024 08:30:46 +0200
Subject: add some banned practices to contributing.md

---
 contributing.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

(limited to 'contributing.md')

diff --git a/contributing.md b/contributing.md
index ab14b71..770d02e 100644
--- a/contributing.md
+++ b/contributing.md
@@ -15,6 +15,22 @@ other document.
 - Images should be placed in the img/ folder
 - Labels and bibliography keys should only consist of characters from the
   following set: `[a-z0-9:-]` (lower-case, numbers, colon, dash).
+- Quotes are opened with the tilde (<code>`</code>)
+
+# Banned practices
+
+- **Using `\newpage`**
+
+  Widows and orphans are handled by LaTeX. If you want to prevent a page break
+  from occurring between two paragraphs, use the `\noparbreak` command at the
+  end of the first paragraph. For larger chunks, the `\needspace{<length>}`
+  command should be used instead.
+- **Using `\href`**
+
+  Add the source in sources.bib and cite this source instead.
+- **Using `\textbf` or `\textit` to emphasize**
+
+  Use `\emph`, single quotes or an em dash (`---`) instead.
 
 # References
 
-- 
cgit v1.2.3