tweak chapter markers some more

3 files changed, 67 insertions, 17 deletions

diff --git a/2022/organizers-notebook/index.org b/2022/organizers-notebook/index.org
index b73e8d43..accde45e 100644
--- a/2022/organizers-notebook/index.org
+++ b/2022/organizers-notebook/index.org
@@ -114,13 +114,11 @@ Previous priorities;
 :PROPERTIES:
 :CUSTOM_ID: harvest
 :END:
-*** STARTED Add audio-only options to the publishing process
+*** DONE Add audio-only options to the publishing process
+CLOSED: [2022-12-15 Thu 16:38]
 :PROPERTIES:
 :Effort:   0:30
 :END:
-:LOGBOOK:
-CLOCK: [2022-12-15 Thu 10:29]
-:END:
 *** Learn from how other conferences harvest their talks and Q&A
 - DebConf posts the talk video (prerecorded + in person Q&A), no transcripts or index
   Ex: https://debconf22.debconf.org/talks/71-sequoia-pgp-v5-openpgp-authentication-and-debian/ . They link to the video and the Etherpad.
@@ -728,6 +726,10 @@ Manual:
 - copy everything, use Emacs News code to refile entries
 - anonymize after
 
+*** TODO improve nil note for missing resources
+:PROPERTIES:
+:CREATED: [2022-12-15 Thu 16:52]
+:END:
 ** TODO Send thanks
 :PROPERTIES:
 :CUSTOM_ID: thanks
diff --git a/2022/talks/dbus.md b/2022/talks/dbus.md
index 593a77eb..714692ec 100644
--- a/2022/talks/dbus.md
+++ b/2022/talks/dbus.md
@@ -12,14 +12,14 @@ Ian Eure (ee-uhn you-er, he/him/his, IRC: ieure)
 
 [[!inline pages="internal(2022/info/dbus-before)" raw="yes"]]
 
-In this talk, I’ll explore uses of D-Bus that supercharge your
-Emacs Operating System.
-
 [[!template id="help" 
-summary="Q&A could be indexed with chapter markers 
+summary="Q&A could be indexed with chapter markers"
 tags="help_with_chapter_markers"
 message="""The Q&A session for this talk does not have chapter markers yet.
-Would you like to help? See [[help_with_chapter_markers]] for more details. You can use the vidid="dbus-qanda", or e-mail your chapter notes to <emacsconf-submit@gnu.org>."""]];
+Would you like to help? See [[help_with_chapter_markers]] for more details. You can use the vidid="dbus-qanda" if adding the markers to this wiki page, or e-mail your chapter notes to <emacsconf-submit@gnu.org>."""]];
+
+In this talk, I’ll explore uses of D-Bus that supercharge your
+Emacs Operating System.
 
 # Discussion
 
diff --git a/help_with_chapter_markers.md b/help_with_chapter_markers.md
index 686558cd..a09a7ce0 100644
--- a/help_with_chapter_markers.md
+++ b/help_with_chapter_markers.md
@@ -1,9 +1,38 @@
 [[!meta title="Pages that need chapter markers"]]
 
-Chapter markers make videos easier to navigate. To add chapter
-markers, make a rough note of the times the sections begin. You can
-add chapter markers by editing the wiki page and adding markup like
-this (example from [[2021/info/native-schedule]]):
+Chapter markers make videos easier to navigate. You can see an example
+of chapter headings in the
+[Q&A for asmblox](https://emacsconf.org/2022/talks/asmblox/).
+
+# Option A: Send us a text file
+
+To add chapter markers, make a rough note of the times the sections
+begin. You can make a text file with the hh:mm:ss or mm:ss timestamps
+and the chapter headings.
+
+    00:00 Introduction
+    01:12 Why did you choose an internal state versus many 'state buffers'?
+    02:10 Do you have plans to port shenzhen.io to Emacs?
+    02:29 Did this use WASM?
+    02:59 Why wasm rather than a more traditional Assembly dialect? It wouldn't be harder to implement, right?
+    05:08 Any next projects on your mind?
+    05:52 Does this work with any other paren-based editing packages?
+    06:46 What kind of tool could use this idea?
+    07:56 How did you go about designing the puzzles?
+    08:39 What are your favorite changes in the upcoming Emacs 29?
+    09:07 Are there tools to add more puzzles?
+
+If you're not sure how something is spelled, you can look at the list
+of questions asked during the Q&A sessions by going to the wiki page
+for the talk, or you can indicate it with `??`.
+
+You can e-mail this to <emacsconf-submit@gnu.org> and we'll update the
+page with the chapters.
+
+# Option B: Edit the wiki page
+
+Another way to add chapter markers is by editing the wiki page and
+adding markup like this (example from [[2021/info/native-schedule]]):
 
 <pre>&#91;&#91;!template id="chapters" vidid="video-qanda" data="""
 00:00 Thanks
@@ -15,8 +44,29 @@ this (example from [[2021/info/native-schedule]]):
 """&#93;&#93;
 </pre>
 
-Chapter markers are particularly useful for Q&A sessions, since they
-can let people jump to the question they're interested in.
+Use the vidid from the help message.
+
+# Option C: Edit the VTT file
+
+Alternatively, you can edit the VTT file (Q&A: `--answers.vtt` if available) and add
+NOTE comments with the chapter headings before the subtitles that are
+part of that chapter. If you're using [subed](https://github.com/sachac/subed) to edit subtitles within
+Emacs, you can split the subtitle as needed with `M-.`
+(`subed-split-subtitle`) so that the subtitle starts with the
+question. You don't have to worry about getting the timestamps exact,
+as we can re-align them with `M-x subed-align`. Here's what that NOTE
+comment can look like:
+
+    NOTE Why did you choose an internal state versus many 'state buffers'?
+    
+    00:01:12.600 --> 00:01:16.039
+    Okay. So, the first question is why did you choose an internal state
+
+These can then be extracted with
+`emacsconf-subed-make-chapter-file-based-on-comments` from `emacsconf-subed.el`
+and included in our publishing workflow.
+
+# Reserving a task
 
 If you want to work on a task that might take you a while, you can
 reserve it by editing the page and setting the `help` template's
@@ -26,8 +76,6 @@ reserve it by editing the page and setting the `help` template's
 If you're not sure how to edit the wiki, you can e-mail your chapter
 notes to <emacsconf-submit@gnu.org> and we can add them for you.
 
-[[Check out these captioning tips.|/captioning]]
-
 The following pages do not yet have chapter markers (usually for long Q&A sessions):
 
 [[!inline pages="tagged(help_with_chapter_markers) and !templates/*" archive="yes" limit="0" trail="yes"]]