From 9d8d7f7cca69555a1d25a470ea49ca9ae4b7c79c Mon Sep 17 00:00:00 2001 From: Sacha Chua Date: Wed, 15 Dec 2021 01:01:34 -0500 Subject: tweak help to include more details --- 2021/talks/bindat.md | 6 +++++- 2021/talks/faster.md | 6 +++++- 2021/talks/janitor.md | 6 +++++- 2021/talks/maintainers.md | 6 +++++- help.md | 4 ++++ help_with_chapter_markers.md | 37 +++++++++++++++++++++++++++++++++++++ help_with_main_captions.md | 5 ++--- 7 files changed, 63 insertions(+), 7 deletions(-) create mode 100644 help_with_chapter_markers.md diff --git a/2021/talks/bindat.md b/2021/talks/bindat.md index 208a0635..9e002e33 100644 --- a/2021/talks/bindat.md +++ b/2021/talks/bindat.md @@ -25,7 +25,11 @@ show how we saved those. Not recommended for birds. # Discussion -[[!template id="help" tags="need_chapter_markers" message="""Want to help make the Q&A session easier to search? You can [add chapter markers](/2021/contribute/#chapter-markers) or [edit the captions](/2021/contribute/#edit-captions), maybe starting with these +[[!template id="help" +summary="long Q&A session needs chapter markers" +volunteer="" +tags="help_with_chapter_markers" +message="""Want to help make the Q&A session easier to search? You can [add chapter markers](/2021/contribute/#chapter-markers) or [edit the captions](/2021/contribute/#edit-captions), maybe starting with these [auto-generated captions](emacsconf-2021-bindat--turbo-bindat--stefan-monnier--answers.ass)."""]] - Q1: bindat seems very similar to GNU Poke (except that GNU Poke is a diff --git a/2021/talks/faster.md b/2021/talks/faster.md index 7b876e0a..5b953010 100644 --- a/2021/talks/faster.md +++ b/2021/talks/faster.md @@ -28,7 +28,11 @@ Preferred contact info | # Discussion -[[!template id="help" tags="need_chapter_markers" message="""Want to help make the Q&A session easier to search? You can [add chapter markers](/2021/contribute/#chapter-markers) or [edit the captions](/2021/contribute/#edit-captions), maybe starting with these +[[!template id="help" +summary="long Q&A session needs chapter markers" +volunteer="" +tags="help_with_chapter_markers" +message="""Want to help make the Q&A session easier to search? You can [add chapter markers](/2021/contribute/#chapter-markers) or [edit the captions](/2021/contribute/#edit-captions), maybe starting with these [auto-generated captions](https://media.emacsconf.org/2021/emacsconf-2021-faster--optimizing-emacs-lisp-code--dmitry-gutov--answers.ass)."""]] IRC nick: dgutov diff --git a/2021/talks/janitor.md b/2021/talks/janitor.md index 5ff2935a..f28a51b6 100644 --- a/2021/talks/janitor.md +++ b/2021/talks/janitor.md @@ -21,7 +21,11 @@ Because of a reckless former Emacs maintainer that shall # Discussion -[[!template id="help" tags="need_chapter_markers" message="""Want to help make the Q&A session easier to search? You can [add chapter markers](/2021/contribute/#chapter-markers) or [edit the captions](/2021/contribute/#edit-captions), maybe starting with these +[[!template id="help" +summary="long Q&A session needs chapter markers" +volunteer="" +tags="help_with_chapter_markers" +message="""Want to help make the Q&A session easier to search? You can [add chapter markers](/2021/contribute/#chapter-markers) or [edit the captions](/2021/contribute/#edit-captions), maybe starting with these [auto-generated captions](https://media.emacsconf.org/2021/emacsconf-2021-janitor--a-day-in-the-life-of-a-janitor--stefan-monnier--answers.ass)."""]] Pad: diff --git a/2021/talks/maintainers.md b/2021/talks/maintainers.md index 05c38539..359104c0 100644 --- a/2021/talks/maintainers.md +++ b/2021/talks/maintainers.md @@ -18,7 +18,11 @@ care of Emacs maintainance by taking care of Emacs maintainers. # Discussion -[[!template id="help" volunteer="sachac 2021-12-14" tags="need_chapter_markers" message="""Want to help make the Q&A session easier to search? You can [add chapter markers](/2021/contribute/#chapter-markers) or [edit the captions](/2021/contribute/#edit-captions), maybe starting with these +[[!template id="help" +summary="long Q&A session needs chapter markers" +volunteer="sachac 2021-12-14" +tags="help_with_chapter_markers" +message="""Want to help make the Q&A session easier to search? You can [add chapter markers](/2021/contribute/#chapter-markers) or [edit the captions](/2021/contribute/#edit-captions), maybe starting with these [auto-generated captions](https://media.emacsconf.org/2021/emacsconf-2021-maintainers--how-to-help-emacs-maintainers---bastien-guerry--answers.ass)."""]] Pad: diff --git a/help.md b/help.md index fa1c859c..6bb366cd 100644 --- a/help.md +++ b/help.md @@ -17,6 +17,10 @@ and [timing information](https://media.emacsconf.org/2021/emacsconf-2021 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 . +Categories: +- [[help with chapter markers]] +- [[help with main captions]] + Here are the pages that need help: [[!inline pages="tagged(help) and !templates/*" archive="yes" limit="0" trail="yes"]] diff --git a/help_with_chapter_markers.md b/help_with_chapter_markers.md new file mode 100644 index 00000000..5731f8c9 --- /dev/null +++ b/help_with_chapter_markers.md @@ -0,0 +1,37 @@ +[[!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]]): + +
[[!template id="chapters" vidid="qanda" data="""
+00:00 Thanks
+01:16 Why is Elisp not a general-purpose programming language, at least not completely?
+02:05 Is this activity related to the garbage collector?
+02:37 Is the idea to eventually develop Emacs itself in Elisp?
+03:42 How did you work on this?
+...
+"""]]
+
+ +Chapter markers are particularly useful for Q&A sessions, since they +can let people jump to the question they're interested in. + +The video IDs are usually `mainVideo` and `qanda`. + +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 +. + +If you're not sure how to edit the wiki, you can e-mail your chapter +notes to and we can add them for you. + +[[Check out these captioning tips.|/captioning]] + +The following pages do not have chapter markers (usually for long Q&A sessions): + +[[!inline pages="tagged(help_with_chapter_markers) and !templates/*" archive="yes" limit="0" trail="yes"]] + +[[Check out other ways to help|help]] diff --git a/help_with_main_captions.md b/help_with_main_captions.md index 2881151f..8aee0edd 100644 --- a/help_with_main_captions.md +++ b/help_with_main_captions.md @@ -6,11 +6,10 @@ 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 . -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"]] + +[[Check out other ways to help|help]] -- cgit v1.2.3