diff options
Diffstat (limited to '2021/talks/tech.md')
-rw-r--r-- | 2021/talks/tech.md | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/2021/talks/tech.md b/2021/talks/tech.md index 6a26281c..c327181d 100644 --- a/2021/talks/tech.md +++ b/2021/talks/tech.md @@ -8,6 +8,8 @@ # Creating technical API documentation and presentations using org-babel, restclient, and org-treeslide Jan Ypma +[[!taglink CategoryOrgMode]] + [[!inline pages="internal(2021/info/tech-schedule)" raw="yes"]] The emacs org-babel package is often mentioned in conjunction with @@ -26,7 +28,22 @@ org-treeslide to write and present technical documentation with style. # Discussion +Pad: + +- Q1: Sorry if you already answered this somewhere (but if not, can + someone with a reddit account copy this over? thx). Hi, I would love + to move my team over to using something org-based, but that'll + never happen because, well... (wait for it) Emacs! By the way, I'm + currently using heavily customized Sphinx setup, mostly internal, + sometimes shared with data partners; lots of schema-gen from message + protocols defined in code, etc. Anyhow: questions. Do you work with + non-Emacs users? If so, how did you get them to accept this + workflow? And if it's just you DJ'ing, how do they weigh in when + they want an update, open a formal ticket? +- <https://github.com/jypma/emacsconf2021/blob/master/presentation.org> + BBB: + - Have you encountered any push-back from people requesting the documentation who are of the opinion that only a Word document will do? - Jan: Not really, I tend to deliver the PDFs only. If more is needed, I expect I'd make a docker container with emacs in it, so people can export the org-file to PDF themselves. - The main problem I have is that effectively they end up branching it in order to use Word's change tracking, and there is no reverse path. @@ -39,6 +56,7 @@ BBB: - Jan: Hold their hands, be kind, small baby steps :) IRC: (nick: jan-ypma) + - I use restclient everyday, but never thought about using it from code blocks, duh! Very interesting talk! - This is a good demo, I've found org-babel to be a really amazing glue language for stuff that's sort of annoying to automate otherwise. - Thanks! :) So the fonts of the current talk are: Fixed pitch (serif): New Heterodox Mono, Variable pitch (serif): ETBembo |