From 886ae437fee6a674f7b2757062f1b8a91275457a Mon Sep 17 00:00:00 2001
From: Sacha Chua <sacha@sachachua.com>
Date: Fri, 8 Oct 2021 01:58:03 -0400
Subject: Add talk pages for 2021

---
 2021/talks/tech.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 2021/talks/tech.md

(limited to '2021/talks/tech.md')

diff --git a/2021/talks/tech.md b/2021/talks/tech.md
new file mode 100644
index 00000000..4a46c629
--- /dev/null
+++ b/2021/talks/tech.md
@@ -0,0 +1,47 @@
+[[!meta title="Creating technical API documentation and presentations using org-babel, restclient, and org-treeslide"]]
+[[!meta copyright="Copyright &copy; 2021 Jan Ypma"]]
+[[!inline pages="internal(2021/info/tech-nav)" raw="yes"]]
+
+<!-- You can manually edit this file to update the abstract, add links, etc. --->
+
+
+# Creating technical API documentation and presentations using org-babel, restclient, and org-treeslide
+Jan Ypma
+
+The emacs org-babel package is often mentioned in conjunction with
+literate programming. The ability to mix code segments with prose
+indeed offers an intuitive way to augment semantic code pieces with
+textual descriptions.
+
+In recent projects, I've started to turn to org-mode as the primary
+format to maintain technical documentation, as well as slides for a
+technical language course. By using org-babel to pull in "live" code
+for REST requests, language examples, and shell scripts, one can be
+sure that the documentation and slides are never out of date.
+
+Two cases are presented:
+
+-   API documentation for a REST service (exported from org to html
+    and PDF)
+-   Slides for a Java Microservice course (presented within emacs,
+    handouts in 2 styles as PDF)
+
+The session will show how leverage org-babel, restclient,
+org-treeslide, as well as show how to create your own language backend
+for org-babel to make sure your own preferred workflow is used.
+
+
+
+# Outline
+
+-   5-10 minutes: We'll pick one of the two use cases and briefly   show
+    it and its result.
+<!---   20 minutes: We'll briefly show both use cases.
+-   40 minutes: We'll show the details how to combine the mentioned
+    packages, as well as showing the custom org-babel backend.
+-->
+
+
+[[!inline pages="internal(2021/info/tech-schedule)" raw="yes"]]
+
+[[!inline pages="internal(2021/info/tech-nav)" raw="yes"]]
-- 
cgit v1.2.3