From ad2f54ecafadb4a14401d983c215ad6f1717490a Mon Sep 17 00:00:00 2001 From: Sacha Chua Date: Wed, 19 Oct 2022 13:03:36 -0400 Subject: document task states --- 2022/organizers-notebook.md | 133 +++++++++++++++++++++++++------------ 2022/organizers-notebook/index.org | 109 ++++++++++++++++++++++-------- 2 files changed, 169 insertions(+), 73 deletions(-) (limited to '2022') 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: @@ -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’s pads -## 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’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 + +- 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 @@ -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 - - -## 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 - - ## 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` + + +## TODO Turn off file upload service on media.emacsconf.org :sachac:infra: + + # 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… 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’re looking for?](#advertising) - [Decision archive](#decision-archive) @@ -1462,7 +1495,7 @@ Ideas: - Worked fine last time - + ## 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’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 - -## How do we want to name the BBB rooms? + + +## 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) - - -## Uh… how should ikiwiki be set up? - -- remove the ikiwiki\_src clone from the ansible config - - -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? @@ -1844,6 +1866,29 @@ Interested in a shift? Please e-mail and - Post more information + + +# Infrastructure notes + + +## Uh… how should ikiwiki be set up? + +- remove the ikiwiki\_src clone from the ansible config + + +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 @@ -2428,7 +2473,7 @@ Probably focus on grabbing the audio first and seeing what’s worth keeping Make a table of the form - +
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 -- cgit v1.2.3