From a0c013e49ff7240c21df3d5be5d4211ed2c5f961 Mon Sep 17 00:00:00 2001
From: Sacha Chua <sacha@sachachua.com>
Date: Wed, 15 Dec 2021 00:52:51 -0500
Subject: let's try fleshing the help pages out

---
 2021/talks/build.md        |  6 +++++-
 2021/talks/clede.md        |  5 ++++-
 help.md                    | 19 +++++++++++++++++++
 help_with_main_captions.md | 16 ++++++++++++++++
 4 files changed, 44 insertions(+), 2 deletions(-)
 create mode 100644 help_with_main_captions.md

diff --git a/2021/talks/build.md b/2021/talks/build.md
index 88ec8bfc..425f6385 100644
--- a/2021/talks/build.md
+++ b/2021/talks/build.md
@@ -10,7 +10,11 @@ Fermin MF
 
 [[!inline pages="internal(2021/info/build-schedule)" raw="yes"]]
 
-[[!template id="help" tags="main_captions" message="""This talk does not have captions yet. Would you like to help [caption this talk](/2021/contribute/#edit-captions)? You may be able to start with these
+[[!template id="help" 
+summary="main talk does not have captions"
+volunteer=""
+tags="help_with_main_captions" 
+message="""This talk does not have captions yet. Would you like to help [caption this talk](/2021/contribute/#edit-captions)? You may be able to start with these
 [autogenerated captions](https://media.emacsconf.org/2021/emacsconf-2021-build--how-to-build-an-emacs--fermin-mf--main.vtt)
 and [timing information](https://media.emacsconf.org/2021/emacsconf-2021-build--how-to-build-an-emacs--fermin-mf.en.srv2)."""]]
 
diff --git a/2021/talks/clede.md b/2021/talks/clede.md
index 2a7ba415..bd01bb83 100644
--- a/2021/talks/clede.md
+++ b/2021/talks/clede.md
@@ -10,7 +10,10 @@ Fermin MF
 
 [[!inline pages="internal(2021/info/clede-schedule)" raw="yes"]]
 
-[[!template id="help" tags="main_captions" message="""This talk does not have captions yet. Would you like to help [caption this talk](/2021/contribute/#edit-captions)? You may be able to start with these
+[[!template id="help" tags="help_with_main_captions"
+summary="main talk does not have captions"
+volunteer=""
+message="""This talk does not have captions yet. Would you like to help [caption this talk](/2021/contribute/#edit-captions)? You may be able to start with these
 [autogenerated captions](https://media.emacsconf.org/2021/emacsconf-2021-clede--clede-the-common-lisp-emacs-development-environment--fermin-mf--main.vtt)
 and [timing information](https://media.emacsconf.org/2021/emacsconf-2021-clede--clede-the-common-lisp-emacs-development-environment--fermin-mf.en.srv2)."""]]
 
diff --git a/help.md b/help.md
index cbb6eacc..fa1c859c 100644
--- a/help.md
+++ b/help.md
@@ -1,3 +1,22 @@
 [[!meta title="Pages that need help"]]
 
+<details>
+<summary>How to add the help marker to a page</summary>
+To add the help marker to a page, you can use something like the following template:
+
+<pre>
+&#91;&#91;!template id="help" 
+summary="main talk does not have captions" 
+tags="help\_with\_main\_captions" 
+message="""This talk does not have captions yet.
+Would you like to help &#91;caption this talk&#93;(/2021/contribute/#edit-captions)? 
+You may be able to start with these &#91;autogenerated captions&#93;(https://media.emacsconf.org/2021/emacsconf-2021-build--how-to-build-an-emacs--fermin-mf--main.vtt)
+and &#91;timing information&#93;(https://media.emacsconf.org/2021/emacsconf-2021-build--how-to-build-an-emacs--fermin-mf.en.srv2)."""&#93;&#93;
+</pre>
+</details>
+
+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 `volunteer` attribute to `your-name date`, or by e-mailing <emacsconf-submit@gnu.org>.
+
+Here are the pages that need help:
+
 [[!inline pages="tagged(help) and !templates/*" archive="yes" limit="0" trail="yes"]]
diff --git a/help_with_main_captions.md b/help_with_main_captions.md
new file mode 100644
index 00000000..2881151f
--- /dev/null
+++ b/help_with_main_captions.md
@@ -0,0 +1,16 @@
+[[!meta title="Talks that need captioning"]]
+
+Want to help make videos easier for people to enjoy during the
+conference, or find and learn from afterwards?  Please volunteer to
+help caption recorded talks!
+
+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 `volunteer` attribute to `your-name date`, or by e-mailing <emacsconf-submit@gnu.org>.
+
+For an Emacs-based solution, [subed.el](https://github.com/rndusr/subed/) mode
+makes it easier to adjust the timings or edit the text.
+
+[[Check out these captioning tips.|/captioning]]
+
+The following talks do not have edited captions:
+
+[[!inline pages="tagged(help_with_main_captions) and !templates/*" archive="yes" limit="0" trail="yes"]]
-- 
cgit v1.2.3