From 70da37b3faa0a6bf3c0282a66e2146cb12bf9b78 Mon Sep 17 00:00:00 2001
From: Erik Schierboom <erik_schierboom@hotmail.com>
Date: Thu, 19 Aug 2021 15:11:38 +0200
Subject: [PATCH] Add shared docs (#189)

---
 config/exercise_readme.go.tmpl  | 13 -------------
 exercises/shared/.docs/help.md  | 12 ++++++++++++
 exercises/shared/.docs/tests.md |  8 ++++++++
 3 files changed, 20 insertions(+), 13 deletions(-)
 delete mode 100644 config/exercise_readme.go.tmpl
 create mode 100644 exercises/shared/.docs/help.md
 create mode 100644 exercises/shared/.docs/tests.md

diff --git a/config/exercise_readme.go.tmpl b/config/exercise_readme.go.tmpl
deleted file mode 100644
index 619a2dc8..00000000
--- a/config/exercise_readme.go.tmpl
+++ /dev/null
@@ -1,13 +0,0 @@
-# {{ .Spec.Name }}
-
-{{ .Spec.Description -}}
-{{- with .Hints }}
-{{ . }}
-{{ end }}
-{{- with .Spec.Credits -}}
-## Source
-
-{{ . }}
-{{ end }}
-## Submitting Incomplete Solutions
-It's possible to submit an incomplete solution so you can see how others have completed the exercise.
diff --git a/exercises/shared/.docs/help.md b/exercises/shared/.docs/help.md
new file mode 100644
index 00000000..cee1099e
--- /dev/null
+++ b/exercises/shared/.docs/help.md
@@ -0,0 +1,12 @@
+# Help
+
+To get help if you're having trouble, you can use one of the following resources:
+
+- [The Emacs Wiki](http://emacswiki.org/) is invaluable. Spend lots of time here.
+- [The Emacs Editor](http://www.gnu.org/software/emacs/manual/html_node/emacs/index.html) is the official manual for GNU Emacs.
+- IRC - there are [freenode](https://freenode.net/) channels for `#emacs`, `#prelude`, and many Emacs
+  packages, and many helpful folks around. And with emacs, IRC is as close as
+  `M-x erc`.
+- [Exercism Support](https://gitter.im/exercism/support) Gitter chat is also a good place to get help from the
+  exercism community.
+- [StackOverflow](http://stackoverflow.com/questions/tagged/elisp) can be used to search for your problem and see if it has been answered already. You can also ask and answer questions.
diff --git a/exercises/shared/.docs/tests.md b/exercises/shared/.docs/tests.md
new file mode 100644
index 00000000..4a32aae4
--- /dev/null
+++ b/exercises/shared/.docs/tests.md
@@ -0,0 +1,8 @@
+# Tests
+
+Tests can be run several ways:
+
+1. Interactively and individually, with `M-x ert RET test-name RET`
+2. Interactively and all at once, with `M-x ert RET t RET`
+3. From the terminal, in batch mode, with `emacs -batch -l ert -l my-test.el -f ert-run-tests-batch-and-exit`
+4. Other options can be found in the docs, `C-h i m ert RET`