From f7dd15b81ca0f31e5abcb6dec30dd64bffa7927f Mon Sep 17 00:00:00 2001
From: Ryan Reece <ryan.d.reece@live.com>
Date: Fri, 27 Oct 2023 18:48:23 -0700
Subject: [PATCH] readme

---
 Makefile  | 36 ++++++++++++++++++++++++++++++++++++
 README.md | 42 +++++++++++++++++++++++++++++++++++++++---
 2 files changed, 75 insertions(+), 3 deletions(-)

diff --git a/Makefile b/Makefile
index 6c08cd7..9e38ac3 100644
--- a/Makefile
+++ b/Makefile
@@ -118,6 +118,42 @@ realclean: clean
 over: realclean default
 
 
+##-----------------------------------------------------------------------------
+## Be careful using these destructive targets
+
+destroy: realclean
+	rm -f *.md
+	$(PRINT) "make $@ done."
+
+destroygit: 
+	rm -rf .git
+	$(PRINT) "make $@ done."
+
+newdoc: destroy destroygit
+	@echo "Introduction" > 01-introduction.md 
+	@echo "===============================================================================" >> 01-introduction.md 
+	@echo "" >> 01-introduction.md 
+	@echo "First subsection" >> 01-introduction.md 
+	@echo "-------------------------------------------------------------------------------" >> 01-introduction.md 
+	@echo "" >> 01-introduction.md 
+	@echo "Start writing..." >> 01-introduction.md 
+	@echo "" >> 01-introduction.md 
+	@echo "" >> 01-introduction.md 
+	@echo "Conclusion" >> 01-introduction.md 
+	@echo "===============================================================================" >> 01-introduction.md 
+	@echo "" >> 01-introduction.md 
+	@echo "Ain't it something?" >> 01-introduction.md 
+	@echo "" >> 01-introduction.md 
+	@echo "" >> 01-introduction.md 
+	@echo "Acknowledgements {.unnumbered}" >> 01-introduction.md 
+	@echo "===============================================================================" >> 01-introduction.md 
+	@echo "" >> 01-introduction.md 
+	@echo "Thanks to everyone who helped with this manuscript." >> 01-introduction.md 
+	@echo "" >> 01-introduction.md 
+	@echo "" >> 01-introduction.md 
+	$(PRINT) "make $@ done."
+
+
 ##-----------------------------------------------------------------------------
 ## install
 ## See: https://askubuntu.com/questions/1335772/using-pandoc-crossref-on-ubuntu-20-04
diff --git a/README.md b/README.md
index 04a4a2e..1abf276 100644
--- a/README.md
+++ b/README.md
@@ -19,19 +19,55 @@ You don't want to think about typesetting details.
 You just want to throw your ideas in some plain text files and call `make`.
 
 
+Quick start
+----------------------------------
+
+Installation:
+
+I'll write installation instructions another time. For now, you can see
+hints in how the GitHub runner does the installation in the CI:
+[`workflows/ci.yml`](https://github.com/rreece/markdown-easy/blob/main/.github/workflows/ci.yml)
+
+Starting a new documents:
+
+*Note: This will delete the markdown files in this example.*
+
+```
+make newdoc
+```
+
+Start writing with a text editor.
+A first example file is created for you: `01-introduction.md`,
+but you can structure you markdown files however you like.
+
+When you are ready to make the document, call
+
+```
+make html
+```
+
+or
+
+```
+make pdf
+```
+
+*More explanation to come.*
+
+
 See also
 ----------------------------------
 
 -   [rreece.github.io/sw/markdown-memo](http://rreece.github.io/sw/markdown-memo)
--   [kprussing.github.io/writing-with-markdown](https://web.archive.org/web/20171026174128/http://kprussing.github.io/writing-with-markdown/)
 -   [pandoc.org/README.html](http://pandoc.org/README.html)
 -   [commonmark.org](http://commonmark.org/)
--   [scholarlymarkdown.com](http://scholarlymarkdown.com/)
 -   [github.com/lierdakil/pandoc-crossref](https://github.com/lierdakil/pandoc-crossref)
 
-Examples/blogs:
+Other examples/blogs of writing with markdown:
 
 -   [programminghistorian.org/lessons/sustainable-authorship-in-plain-text-using-pandoc-and-markdown](http://programminghistorian.org/lessons/sustainable-authorship-in-plain-text-using-pandoc-and-markdown)
+-   [kprussing.github.io/writing-with-markdown](https://web.archive.org/web/20171026174128/http://kprussing.github.io/writing-with-markdown/)
+-   [scholarlymarkdown.com](http://scholarlymarkdown.com/)
 -   [github.com/simov/markdown-syntax](https://github.com/simov/markdown-syntax/blob/main/mermaid.md)
 -   [markdownguide.org](https://www.markdownguide.org/getting-started/) --- source: [github.com/mattcone/markdown-guide-book](https://github.com/mattcone/markdown-guide-book/blob/master/manuscript/chapter3.md)
 -   [github.com/gabyx/Technical-Markdown](https://github.com/gabyx/Technical-Markdown)