document task states

2 files changed, 169 insertions, 73 deletions

diff --git a/2022/organizers-notebook.md b/2022/organizers-notebook.md
index 60065870..83460626 100644
--- a/2022/organizers-notebook.md
+++ b/2022/organizers-notebook.md
@@ -13,6 +13,7 @@ This file is automatically exported from [/2022/organizers-notebook/index.org](/
 -   [Projects to bear in mind but which are not actual](#maybe-projects)
 -   [Things to figure out / decisions to make](#decisions)
 -   [Roles needed](#roles)
+-   [Infrastructure notes](#infra)
 -   [Other tasks and processes](#other)
 -   [Task archive](#archive)
 -   [Communications](#comms)
@@ -43,14 +44,14 @@ Other projects:
 -   [Add nice-to-have stuff to prepare.md](#extra-prepare):zaeph:
 -   [Find volunteers for tech-checks](#tech-checks):zaeph:
 -   [Update viewing instructions and watch pages](#write-viewing):sachac:
--   [Make talk pages easy to update when the talk is live](#publish-live):sachac:
+-   [Prepare to handle talk state changes](#publish-live):sachac:
 -   [Set up talks on Toobnix and YouTube](#video-platforms):sachac:
 -   [Set up stream events on Toobnix and YouTube](#other-streams):sachac:
--   [Prepare to announce talks on IRC](#irc-announce)
 -   [Ask speakers for bios or support nudges to include on their talk pages](#speaker-bio)
 -   [Do a dry run](#dry-run)
 -   [Figure out why ikiwiki is slow](#ikiwiki-regex):infra:wiki:
 -   [Add category tags and possibly links between talks across 2022 and all previous years](#link-pages):needsowner:wiki:
+-   [Turn off file upload service on media.emacsconf.org](#upload-off):sachac:infra:
 
 
 <a id="cadence"></a>
@@ -527,14 +528,14 @@ Sacha Chua
 -   [Add nice-to-have stuff to prepare.md](#extra-prepare):zaeph:
 -   [Find volunteers for tech-checks](#tech-checks):zaeph:
 -   [Update viewing instructions and watch pages](#write-viewing):sachac:
--   [Make talk pages easy to update when the talk is live](#publish-live):sachac:
+-   [Prepare to handle talk state changes](#publish-live):sachac:
 -   [Set up talks on Toobnix and YouTube](#video-platforms):sachac:
 -   [Set up stream events on Toobnix and YouTube](#other-streams):sachac:
--   [Prepare to announce talks on IRC](#irc-announce)
 -   [Ask speakers for bios or support nudges to include on their talk pages](#speaker-bio)
 -   [Do a dry run](#dry-run)
 -   [Figure out why ikiwiki is slow](#ikiwiki-regex):infra:wiki:
 -   [Add category tags and possibly links between talks across 2022 and all previous years](#link-pages):needsowner:wiki:
+-   [Turn off file upload service on media.emacsconf.org](#upload-off):sachac:infra:
 
 Ordered by importance.
 
@@ -1127,7 +1128,47 @@ Maybe links to the current shift&rsquo;s pads
 
 <a id="publish-live"></a>
 
-## TODO Make talk pages easy to update when the talk is live     :sachac:
+## TODO Prepare to handle talk state changes     :sachac:
+
+
+### Talk states
+
+-   **WAITING\_FOR\_PREREC(p):** waiting for the speaker to upload. Use this
+    to nudge people weekly after the deadline, keeping PREREC\_INFO in
+    mind for speakers who have told us they&rsquo;ll need extra time.
+-   **TO\_PROCESS(a):** talk has been uploaded. zaeph will rename it,
+    process it using ffmpeg/audacity, and then put it in
+    media.emacsconf.org/2022/backstage along with any related files.
+-   **TO\_AUTOCAP(y):** sachac will prepare automated captions for easier editing
+-   **TO\_ASSIGN(a):** captioning volunteers can call dibs on this talk by
+    e-mailing sacha@sachachua.com. talk will be listed on media.emacsconf.org/2022/backstage/index.html
+-   **TO\_CAPTION(c):** captioning is in progress. CAPTIONER property is set to the volunteer.
+-   **TO\_STREAM(s):** talk is captioned and ready to play. Transcript directives are prepared so that the talk can be published with the transcript when it streams.
+-   **PLAYING(m):** talk is being streamed live; announce in IRC and publish prerec and other resources on talk page
+-   **CLOSED\_Q(q):** host is doing closed Q&A session with speaker; announce Q&A in IRC, friendly BBB page should refresh with waiting message
+-   **OPEN\_Q(o):** host is doing open Q&A session with speaker, friendly BBB page should redirect to BBB; update IRC and Etherpad
+-   **UNSTREAMED\_Q(u):** Q&A session with speaker continues off the stream because another talk has started playing; list on current page
+-   **TO\_ARCHIVE:** Q&A session has ended; update talk page and current page. At some point, archive the pad and IRC onto the talk page.
+-   **TO\_EXTRACT:** Extract the recording from the Q&A room
+-   **TO\_FOLLOW\_UP:** Send questions to the speaker for follow-up
+-   **DONE(x):** all done, yay!
+-   **CANCELLED(!):** maybe next time
+
+Other things that aren&rsquo;t tracked by todo status:
+
+-   **CHECKED\_IN: t:** once the speaker has been checked into the BBB room or IRC
+
+
+<a id="irc-announce"></a>
+
+### TODO Prepare to announce talks on IRC
+
+-   talks should be announced in their relevant track channel and in the main channel
+    -   video starting in 5 minutes
+    -   video starting now
+    -   Q&A starting now & where
+-   a small announcement might go into the other track as well
+-   announcement can include talk page, pad, IRC nick, pronouns
 
 
 <a id="video-platforms"></a>
@@ -1148,18 +1189,6 @@ so that people on other platforms can come across EmacsConf
     while true; do ffmpeg -loglevel 24 -i http://localhost:8000/main.webm -cluster_size_limit 2M -cluster_time_limit 5100 -b:v 1M -crf 30 -g 125 -deadline good -threads 4 -vcodec libx264 -acodec libmp3lame -f flv $MOUNT; done
 
 
-<a id="irc-announce"></a>
-
-## TODO Prepare to announce talks on IRC
-
--   talks should be announced in their relevant track channel and in the main channel
-    -   video starting in 5 minutes
-    -   video starting now
-    -   Q&A starting now & where
--   a small announcement might go into the other track as well
--   announcement can include talk page, pad, IRC nick, pronouns
-
-
 <a id="speaker-bio"></a>
 
 ## TODO Ask speakers for bios or support nudges to include on their talk pages
@@ -1224,6 +1253,11 @@ should the captions be outside the wiki?
     You can make a new heading called `# Related talks`
 
 
+<a id="upload-off"></a>
+
+## TODO Turn off file upload service on media.emacsconf.org     :sachac:infra:
+
+
 <a id="maybe-projects"></a>
 
 # Projects to bear in mind but which are not actual
@@ -1249,9 +1283,8 @@ Note on how DebConf handled incidents:
 -   [How do we want to make better use of Etherpad?](#pad-decision)
 -   [Can we nudge people to ask IRC questions in a way that will make it easier for us to follow them?](#irc-markers)
 -   [How many BBB rooms do we want to set up?](#bbb-rooms)
--   [How easy do we want to make it to join the BBB session?](#org9ce4f4f)
--   [How do we want to name the BBB rooms?](#org28ce23b)
--   [Uh&#x2026; how should ikiwiki be set up?](#org799d9e4)
+-   [How easy do we want to make it to join the BBB session?](#bbb-join)
+-   [How do we want to name the BBB rooms?](#bbb-name)
 -   [Do we want people to advertise any openings with their companies or any work that they&rsquo;re looking for?](#advertising)
 -   [Decision archive](#decision-archive)
 
@@ -1462,7 +1495,7 @@ Ideas:
     -   Worked fine last time
 
 
-<a id="org9ce4f4f"></a>
+<a id="bbb-join"></a>
 
 ## How easy do we want to make it to join the BBB session?
 
@@ -1489,10 +1522,19 @@ Options:
         able to change the setting any time.
     -   Waiting users don&rsquo;t make the user notification go ding.
 
+Change talk status to OPEN\_Q or UNSTREAMED\_Q, and change to TO\_ARCHIVE when done.
+M-x emacsconf-publish-bbb-redirect to update the redirect for a single talk
+M-x emacsconf-publish-bbb-redirect-all updates all the redirects
+
+
+### TODO Add nginx redirect from emacsconf.org
+
+/ssh:front|sudo::/etc/nginx/sites-available/emacsconf.org
 
-<a id="org28ce23b"></a>
 
-## How do we want to name the BBB rooms?
+<a id="bbb-name"></a>
+
+## DONE How do we want to name the BBB rooms?
 
 Needs to be easy to:
 
@@ -1505,26 +1547,6 @@ Needs to be easy to:
 ec22-sat-am-dev Speaker Name (slugs)
 
 
-<a id="org799d9e4"></a>
-
-## Uh&#x2026; how should ikiwiki be set up?
-
--   remove the ikiwiki\_src clone from the ansible config
-
-<https://ikiwiki.info/rcs/git/>
-bare repo has a post-update hook that updates the src repo
-src repo is ~ikiwiki/emacsconf
-~git/repositories/pub/emacsconf-wiki.git/hooks/post-update runs ~git/repositories/pub/emacsconf-wiki.git/hooks/post-update.h00-ikiwiki-wrapper
-there is an anon mirror that&rsquo;s updated with sudo -u anon /home/anon/fetch-wiki
-the git wrapper is
-/home/ikiwiki/hooks/emacsconf
-
-~anon/emacsconf-wiki.git has origin  git@git.emacsconf.org:pub/emacsconf-wiki (fetch)
-but git log does not have the new stuff
-Where is the new stuff?
-&#x2026; hah, maybe I forgot to push
-
-
 <a id="advertising"></a>
 
 ## Do we want people to advertise any openings with their companies or any work that they&rsquo;re looking for?
@@ -1844,6 +1866,29 @@ Interested in a shift? Please e-mail <mailto:emacsconf-org-private@gnu.org> and
     -   Post more information
 
 
+<a id="infra"></a>
+
+# Infrastructure notes
+
+
+## Uh&#x2026; how should ikiwiki be set up?
+
+-   remove the ikiwiki\_src clone from the ansible config
+
+<https://ikiwiki.info/rcs/git/>
+bare repo has a post-update hook that updates the src repo
+src repo is ~ikiwiki/emacsconf
+~git/repositories/pub/emacsconf-wiki.git/hooks/post-update runs ~git/repositories/pub/emacsconf-wiki.git/hooks/post-update.h00-ikiwiki-wrapper
+there is an anon mirror that&rsquo;s updated with sudo -u anon /home/anon/fetch-wiki
+the git wrapper is
+/home/ikiwiki/hooks/emacsconf
+
+~anon/emacsconf-wiki.git has origin  git@git.emacsconf.org:pub/emacsconf-wiki (fetch)
+but git log does not have the new stuff
+Where is the new stuff?
+&#x2026; hah, maybe I forgot to push
+
+
 <a id="other"></a>
 
 # Other tasks and processes
@@ -2428,7 +2473,7 @@ Probably focus on grabbing the audio first and seeing what&rsquo;s worth keeping
 
 Make a table of the form
 
-<table id="org19977e3" border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
+<table id="orga831537" border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
 
 
 <colgroup>
diff --git a/2022/organizers-notebook/index.org b/2022/organizers-notebook/index.org
index a656e39e..2ec0497e 100644
--- a/2022/organizers-notebook/index.org
+++ b/2022/organizers-notebook/index.org
@@ -708,10 +708,48 @@ CLOSED: [2022-10-17 Mon 00:39]
 Maybe links to the current shift's pads
 *** TODO Add pad to sched directive so that it will be linked when the pads are live
 *** TODO Update https://live.emacsconf.org/ as well
-** TODO Make talk pages easy to update when the talk is live        :sachac:
+** TODO Prepare to handle talk state changes                        :sachac:
 :PROPERTIES:
 :CUSTOM_ID: publish-live
 :END:
+*** Talk states
+
+- WAITING_FOR_PREREC(p) :: waiting for the speaker to upload. Use this
+  to nudge people weekly after the deadline, keeping PREREC_INFO in
+  mind for speakers who have told us they'll need extra time.
+- TO_PROCESS(a) :: talk has been uploaded. zaeph will rename it,
+  process it using ffmpeg/audacity, and then put it in
+  media.emacsconf.org/2022/backstage along with any related files.
+- TO_AUTOCAP(y) :: sachac will prepare automated captions for easier editing
+- TO_ASSIGN(a) :: captioning volunteers can call dibs on this talk by
+  e-mailing sacha@sachachua.com. talk will be listed on media.emacsconf.org/2022/backstage/index.html
+- TO_CAPTION(c) :: captioning is in progress. CAPTIONER property is set to the volunteer.
+- TO_STREAM(s) :: talk is captioned and ready to play. Transcript directives are prepared so that the talk can be published with the transcript when it streams.
+- PLAYING(m) :: talk is being streamed live; announce in IRC and publish prerec and other resources on talk page
+- CLOSED_Q(q) :: host is doing closed Q&A session with speaker; announce Q&A in IRC, friendly BBB page should refresh with waiting message
+- OPEN_Q(o) :: host is doing open Q&A session with speaker, friendly BBB page should redirect to BBB; update IRC and Etherpad
+- UNSTREAMED_Q(u) :: Q&A session with speaker continues off the stream because another talk has started playing; list on current page
+- TO_ARCHIVE :: Q&A session has ended; update talk page and current page. At some point, archive the pad and IRC onto the talk page.
+- TO_EXTRACT :: Extract the recording from the Q&A room
+- TO_FOLLOW_UP :: Send questions to the speaker for follow-up
+- DONE(x) :: all done, yay!
+- CANCELLED(!) :: maybe next time
+
+Other things that aren't tracked by todo status:
+- CHECKED_IN: t :: once the speaker has been checked into the BBB room or IRC
+  
+*** TODO Prepare to announce talks on IRC
+:PROPERTIES:
+:CUSTOM_ID: irc-announce
+:END:
+
+- talks should be announced in their relevant track channel and in the main channel
+  - video starting in 5 minutes
+  - video starting now
+  - Q&A starting now & where
+- a small announcement might go into the other track as well
+- announcement can include talk page, pad, IRC nick, pronouns
+  
 ** BLOCKED Set up talks on Toobnix and YouTube                      :sachac:
 :PROPERTIES:
 :CUSTOM_ID: video-platforms
@@ -729,18 +767,6 @@ so that people on other platforms can come across EmacsConf
      MOUNT=$1
      while true; do ffmpeg -loglevel 24 -i http://localhost:8000/main.webm -cluster_size_limit 2M -cluster_time_limit 5100 -b:v 1M -crf 30 -g 125 -deadline good -threads 4 -vcodec libx264 -acodec libmp3lame -f flv $MOUNT; done
   #+end_src
-** TODO Prepare to announce talks on IRC
-:PROPERTIES:
-:CUSTOM_ID: irc-announce
-:END:
-
-- talks should be announced in their relevant track channel and in the main channel
-  - video starting in 5 minutes
-  - video starting now
-  - Q&A starting now & where
-- a small announcement might go into the other track as well
-- announcement can include talk page, pad, IRC nick, pronouns
-  
 ** TODO Ask speakers for bios or support nudges to include on their talk pages
 :PROPERTIES:
 :CUSTOM_ID: speaker-bio
@@ -803,6 +829,9 @@ should the captions be outside the wiki?
   You can make a new heading called =# Related talks=
 ** TODO Turn off file upload service on media.emacsconf.org  :sachac:infra:
 SCHEDULED: <2022-12-14 Wed>
+:PROPERTIES:
+:CUSTOM_ID: upload-off
+:END:
 * Projects to bear in mind but which are not actual
 :PROPERTIES:
 :CUSTOM_ID: maybe-projects
@@ -1000,6 +1029,9 @@ Ideas:
   - Check-in person directs the speaker to the next available room
   - Worked fine last time
 ** How easy do we want to make it to join the BBB session?
+:PROPERTIES:
+:CUSTOM_ID: bbb-join
+:END:
 Considerations:
 - It's easier for the checkin person to deal with only the speaker
 - We may not want people to join the Q&A session at the beginning
@@ -1021,7 +1053,17 @@ Options:
     ongoing meeting, even though the web interface says you should be
     able to change the setting any time.
   - Waiting users don't make the user notification go ding.
-** How do we want to name the BBB rooms?
+
+Change talk status to OPEN_Q or UNSTREAMED_Q, and change to TO_ARCHIVE when done.
+M-x emacsconf-publish-bbb-redirect to update the redirect for a single talk
+M-x emacsconf-publish-bbb-redirect-all updates all the redirects
+*** TODO Add nginx redirect from emacsconf.org
+/ssh:front|sudo::/etc/nginx/sites-available/emacsconf.org
+** DONE How do we want to name the BBB rooms?
+CLOSED: [2022-10-19 Wed 11:08]
+:PROPERTIES:
+:CUSTOM_ID: bbb-name
+:END:
 
 Needs to be easy to:
 - share all the BBB rooms for a particular shift with the check-in volunteer
@@ -1032,21 +1074,6 @@ Needs to be easy to:
   
 ec22-sat-am-dev Speaker Name (slugs)
 
-** Uh... how should ikiwiki be set up?
-
-- remove the ikiwiki_src clone from the ansible config
-https://ikiwiki.info/rcs/git/
-bare repo has a post-update hook that updates the src repo
-src repo is ~ikiwiki/emacsconf
-~git/repositories/pub/emacsconf-wiki.git/hooks/post-update runs ~git/repositories/pub/emacsconf-wiki.git/hooks/post-update.h00-ikiwiki-wrapper
-there is an anon mirror that's updated with sudo -u anon /home/anon/fetch-wiki
-the git wrapper is
-/home/ikiwiki/hooks/emacsconf
-
-~anon/emacsconf-wiki.git has origin  git@git.emacsconf.org:pub/emacsconf-wiki (fetch)
-but git log does not have the new stuff
-Where is the new stuff?
-... hah, maybe I forgot to push
 
 ** Do we want people to advertise any openings with their companies or any work that they're looking for?
 :PROPERTIES:
@@ -1227,6 +1254,30 @@ Interested in a shift? Please e-mail [[mailto:emacsconf-org-private@gnu.org]] an
   - Summarize Q&A
 - Publisher
   - Post more information
+* Infrastructure notes
+:PROPERTIES:
+:CUSTOM_ID: infra
+:END:
+
+** Uh... how should ikiwiki be set up?
+:PROPERTIES:
+:CUSTOM_ID: ikiwiki
+:END:
+
+- remove the ikiwiki_src clone from the ansible config
+https://ikiwiki.info/rcs/git/
+bare repo has a post-update hook that updates the src repo
+src repo is ~ikiwiki/emacsconf
+~git/repositories/pub/emacsconf-wiki.git/hooks/post-update runs ~git/repositories/pub/emacsconf-wiki.git/hooks/post-update.h00-ikiwiki-wrapper
+there is an anon mirror that's updated with sudo -u anon /home/anon/fetch-wiki
+the git wrapper is
+/home/ikiwiki/hooks/emacsconf
+
+~anon/emacsconf-wiki.git has origin  git@git.emacsconf.org:pub/emacsconf-wiki (fetch)
+but git log does not have the new stuff
+Where is the new stuff?
+... hah, maybe I forgot to push
+
 * Other tasks and processes
 :PROPERTIES:
 :CUSTOM_ID: other