summaryrefslogtreecommitdiffstats
path: root/2022
diff options
context:
space:
mode:
authorSacha Chua <sacha@sachachua.com>2022-10-19 13:03:36 -0400
committerSacha Chua <sacha@sachachua.com>2022-10-19 13:03:36 -0400
commitad2f54ecafadb4a14401d983c215ad6f1717490a (patch)
tree14b980956b169faf3adc4a8501a836e05dc7431a /2022
parent56ec60110b85ead89b3ef7d972e41ff5f21c6f46 (diff)
downloademacsconf-wiki-ad2f54ecafadb4a14401d983c215ad6f1717490a.tar.xz
emacsconf-wiki-ad2f54ecafadb4a14401d983c215ad6f1717490a.zip
document task states
Diffstat (limited to '')
-rw-r--r--2022/organizers-notebook.md133
-rw-r--r--2022/organizers-notebook/index.org109
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