Code Monkey home page Code Monkey logo

meetings's Introduction

W3C Credentials Community Group Meetings Archive

This repo contains the meeting archives for the W3C-CCG (Credentials Community Group), including transcripts based on the IRC logs and audio files for our regular meetings, ancillary material such as slide presentations, etc. The archives for 2014-2019 can be found here.

Notes on archive process

This section describes how the chairs archive W3C-CCG meetings, including sending the agenda, how to run the meetings, and how to publish CCG minutes transcript and audio after. This information is also used for leads and other facilitators archiving any alternative CCG meetings such as task forces and special meetings.

Before Meeting (Agenda for the weekly W3C-CCG Chairs meeting)

Before Meeting (Task Force & Others)

During Meeting (All Meetings)

  • Make sure to link to the agenda at the beginning of the meeting ("Agenda: ...")
  • Make sure the scribe is identified ("Scribe: ...")
  • Make sure topics are labeled when the topic changes ("Topic: ...")
  • Make sure that action items are listed so that they can be added to issues later ("Action: ...")
  • Mark approved work items with "approved" github label

Publish the minutes (for CCG meetings, task forces and other recorded meetings)

Add Action Items to Issues (All Meetings)

Review meeting log for any Action items (conveniently added to top of minutes by script), and add them to community issues with appropriate issue tag and owner. Work Item and Task Force leads are welcome to use their own tags.

meetings's People

Contributors

aviloria88 avatar benjaminmoe avatar bigbluehat avatar brownoxford avatar bumblefudge avatar christophera avatar clehner avatar davidlehn avatar dependabot[bot] avatar dmitrizagidulin avatar gannan08 avatar ildikomazar avatar jandrieu avatar kayaelle avatar kevinz917 avatar kimdhamilton avatar mkhraisha avatar msporny avatar nissimsan avatar omahs avatar peacekeeper avatar petepetepeter avatar rhiaro avatar rhofvendahl avatar simoneravaioli avatar vanessafxu avatar vsnt avatar w3cccg avatar wyc avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

meetings's Issues

Scribe Tool: Enable Fetch by Date for Task Forces

In /scribe-tool/index.html the fetchLog function searches by data for a Jitsi url path that is specific to CCG like:

https://meet.w3c-ccg.org/archives/w3c-ccg-weekly-"+dateString+"-irc.log

Task force URLs vary such as for VC-EDU like:

https://meet.w3c-ccg.org/archives/w3c-ccg-education-"+dateString+"-irc.log

but fetchLog isn't aware of this.

If someone provides the Jitsi urls for the task forces in this issue, we can update scribe tool to search for task force minutes which will make generating and sharing the meetings much more efficient for the task forces.

Consider a separate repo for scribe-tool / scripts

This repo is massive because of all of the audio files, and it takes ages to fetch it the first time, and is pretty slow to fetch subsequent updates. When I just want to tweak scribe-tool, it's quite burdensome to download all of these audio files to my local machine.

I think it would be a suitable separation of concerns to keep this repo only for minutes/recordings, and have the 'plumbing' elsewhere. We could still keep a github pages scribe-tool page here (ie at w3c-ccg.github.io/meetings/scribe-tool) if that's desired by including the JS from another repo.

Twitter CI action failing

Getting the following error when attempting to generate VC-Edu meeting minutes:

image

The Twitter notification CI step is failing, because I don't have correct credentials, or something.
Do we /need/ a Twitter CI step?

Configurability of github actions

These items would help:

  • configurable tweet
  • configurable email title (e.g. edu vc vs regular calls)
  • include link to instructions about cleaning up minutes

Add a delay to minutes sending

Github pages can take up to 5 minutes to build, so often the link to generated minutes is sent out by email and twitter before the page is ready. Maybe we can add a delay in the github actions script to minimise chances of people clicking the link immediately and getting a 404.

Admittedly the only people likely to do that are the people generating the minutes, to check it worked, so not high priority.. but just in case..

Long term: updates to the scripts to make it easier for task forces to use

For the IFTF to discuss.

Ted's comment here points out that task force minutes for the DID resolution group looks different from the main CCG group (and VC-EDU). Truth is, it takes some wrangling to work with these scripts if you're not using the default CCG tools.

Whether the IFTF wants to support task forces that don't use Jitsi is one question they should consider. If they do want to, I wanted to share my experience based on the VC-EDU task force.

The index.js and scrawl.js scripts are quite tangled, generating both the summary index.html and individual index.html off of the irc.log file (and they'll try to recreate, making it tricky in the current form to directly write .html), so I found it was easiest to force my formats into the irc.log format; e.g

<date>\t<alias>\t<message>

Within that message, the scrawl script will look for magic words like "Action:", etc.

Going that path of least resistance, I ended up creating 2 command line tools:

  1. vtt2irc: takes a zoom auto-transcribed transcript and converts it to irc.log. I stopped using it because these transcripts are very noisy.
  2. txt2irc: takes a simpler txt file that basically contains <message> and converts it to an irc.log the scripts are happy with.

More about txt2irc: note that, in VC-EDU, our task force members decided that we wanted the audio recording and a much shorter summary: decisions + resolutions. Because we are very "working session" oriented, most of our work happens in github anyway, so the scribe function is sort of a distraction.

I also experimented with a cleaner solution involving mustache templates, but it because too messy because of the above-mentioned script entanglement, so I abandoned it.

What's interesting is that @peacekeeper seems to have landed on this same pattern as VC-EDU did; i.e meetings are working session oriented. Most of the work happens in github, and minutes are only needed for very high-level things.

This issue is mostly to capture my thinking on the topic while it's fresh, so that the IFTF can decide how they want to pursue this, including if they want to not support this path. But because our two current active TFs seem to be using patterns where CCG scripts are cumbersome, I thought you might want to be aware.

If you find any of my utilities useful, I'll happily transfer them to the ccg org.

Scribe Tool: Task Force Chairs Don't Appear to Get Pulled into index.html

The organizers in index.html of the meeting notes are listed as "Wayne Chang", "Heather Vescent", "Mike Prorock" when they should be the co-chairs of the meeting topic/task force.

It looks like when the index.html in scribe-tool is run it initializes the scrawl with scrawl.chair = config[0].chairs forcing the first item in the array to be used. Based on other functionality, it looks like this should rely on the group.txt value?

transcriber fails mid-meeting, and transcriber doesn't hear some speakers

These might be appropriate for a different repo. I'm logging them here as "most likely repo" thanks to Dmitri's CCG sleuthing. Feel free to move or copy them to other repos. Please tag me if you do so, so I can track updates.

These probably need to be handled distinctly, but they're intimately connected so I'm raising one issue for both.

1. transcriber fails mid-meeting

Historically, this was handled by stopping and restarting the recording, but apparently that resulted in overwriting the existing recording (up to "now") with the new recording (starting "now"), so the earlier part of the meeting was lost.

This could be partially handled by naming the recording file with DATETIME instead of just DATE, perhaps rounding to the minute (dropping seconds and fractions thereof). That would make the admin functions a bit more challenging, but would at least keep as much recording as the day's chair was able to capture with timely re-starts.

After-meeting post-processing of the recording to generate a transcript could then be used against all the audio files, hopefully resulting in something more complete than the mid-meeting failure delivers.

2. transcriber doesn't hear some speakers

This is an ongoing problem, which might be related to browser-specific issues on the speaker's side, but the speaker isn't always able to drop-and-reconnect or to change browsers.

This would be less of an issue if the recording is complete, or if the post-processing described above can be run (assuming the recording captures all speakers, even when the transcriber doesn't), but it's still problematic during the meeting.

Security vulnerability reported in this repo

Opening this repo we see:

We found potential security vulnerabilities in your dependencies.
Some of the dependencies defined in scribe-tool/package.json have known security vulnerabilities and should be updated.

Only users who have been granted access to vulnerability alerts for this repository can see this message.

Learn more about vulnerability alerts

GitHub Action improvements

We just made some general improvements to the various GitHub Actions running here, but more is needed based on the logs from this most recent run: https://github.com/w3c-ccg/meetings/actions/runs/9387952522

Mainly, the file changes system we've been using hasn't been touched in sometime, so we should consider moving to https://github.com/tj-actions/changed-files

Also, set-output is deprecated, and we should move to using $GITHUB_STATE per https://github.blog/changelog/2022-10-11-github-actions-deprecating-save-state-and-set-output-commands/#examples

We may also want to look into using https://github.com/nektos/act for local GitHub Action testing (probably coupled with some mail trap system).

Never a dull moment. ๐Ÿ˜‰

send-email component of github action is failing

Look at Action logs in the week of 6/22-25 for failure messages. Essentially we can no longer send through the w3c-ccg gmail account, and it broke when we switched over ownership of the account. We need someone to investigate and fix

Scribe tool wish list / small bugs log

Extensions of @rhiaro's scribe_tool improvements:

  • automate cleanup ui -> git - I think scribe-tool can already talk to
    the git API, just needs hooking up to the the frontend and some api
    token magic..
  • have ccg-bot automatically offer up the cleanup URL in IRC once the
    call ends for the designated logs-cleaner to click on (in SocialWG this
    used to also be the scribe's job - and I made a similar web tool for
    that too - so it was a different person every week, though in practice I
    ended up doing it a lot of the time anyway).
  • make the scribe-tool UI actually look nice.

Backfill audio

We'll need to backfill audio recordings from the beginning of 2020 til whenever we automate audio as part of github actions

Fix CCG minutes.

Meeting transcript generation improvements

From @msporny, we could improve the ease of creating meeting transcripts as follows:

  1. A way to stream IRC logging to a public website.
  2. A way to send the audio record to a public website.

Once we have that working, most anyone could clean up the minutes.

The specific capabilities that we need are:

  1. A website that can keep logs (separated by CG/WG), so something that
    allows the IRC bot to send single IRC line POSTs to
    https://example.com/ccg/2017-07-28.log
  2. The same for audio: https://example.com/ccg/2017-07-28-audio.wav

We need a simple server that is capable of doing that.

Publishing minutes deployments failing

Files are getting generated but html url is serving a 404.

See error:

System.IO.IOException: No space left on device : '/home/runner/runners/2.309.0/_diag/Worker_20231003-184749-utc.log'
at System.IO.RandomAccess.WriteAtOffset(SafeFileHandle handle, ReadOnlySpan1 buffer, Int64 fileOffset) at System.IO.Strategies.BufferedFileStreamStrategy.FlushWrite() at System.IO.StreamWriter.Flush(Boolean flushStream, Boolean flushEncoder) at System.Diagnostics.TextWriterTraceListener.Flush() at GitHub.Runner.Common.HostTraceListener.WriteHeader(String source, TraceEventType eventType, Int32 id) at GitHub.Runner.Common.HostTraceListener.TraceEvent(TraceEventCache eventCache, String source, TraceEventType eventType, Int32 id, String message) at System.Diagnostics.TraceSource.TraceEvent(TraceEventType eventType, Int32 id, String message) at GitHub.Runner.Worker.Worker.RunAsync(String pipeIn, String pipeOut) at GitHub.Runner.Worker.Program.MainAsync(IHostContext context, String[] args) System.IO.IOException: No space left on device : '/home/runner/runners/2.309.0/_diag/Worker_20231003-184749-utc.log' at System.IO.RandomAccess.WriteAtOffset(SafeFileHandle handle, ReadOnlySpan1 buffer, Int64 fileOffset)
at System.IO.Strategies.BufferedFileStreamStrategy.FlushWrite()
at System.IO.StreamWriter.Flush(Boolean flushStream, Boolean flushEncoder)
at System.Diagnostics.TextWriterTraceListener.Flush()
at GitHub.Runner.Common.HostTraceListener.WriteHeader(String source, TraceEventType eventType, Int32 id)
at GitHub.Runner.Common.HostTraceListener.TraceEvent(TraceEventCache eventCache, String source, TraceEventType eventType, Int32 id, String message)
at System.Diagnostics.TraceSource.TraceEvent(TraceEventType eventType, Int32 id, String message)
at GitHub.Runner.Common.Tracing.Error(Exception exception)
at GitHub.Runner.Worker.Program.MainAsync(IHostContext context, String[] args)
Unhandled exception. System.IO.IOException: No space left on device : '/home/runner/runners/2.309.0/_diag/Worker_20231003-184749-utc.log'
at System.IO.RandomAccess.WriteAtOffset(SafeFileHandle handle, ReadOnlySpan`1 buffer, Int64 fileOffset)
at System.IO.Strategies.BufferedFileStreamStrategy.FlushWrite()
at System.IO.StreamWriter.Flush(Boolean flushStream, Boolean flushEncoder)
at System.Diagnostics.TextWriterTraceListener.Flush()
at System.Diagnostics.TraceSource.Flush()
at GitHub.Runner.Common.TraceManager.Dispose(Boolean disposing)
at GitHub.Runner.Common.TraceManager.Dispose()
at GitHub.Runner.Common.HostContext.Dispose(Boolean disposing)
at GitHub.Runner.Common.HostContext.Dispose()
at GitHub.Runner.Worker.Program.Main(String[] args)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.