nodejs / nodejs/admin

Move bnb/join to nodejs/join or nodejs/meet

Open
#546 12 comments 14 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

approved
Dominant language
JavaScript
Stars
202
Forks
183
Avg merge
2m
Merged PRs (30d)
1

Description

I've gotten a bit tired of having to open up the GItHub issue for meetings just to access the join link, and I'd rather not fill up my bookmarks bar with random join links.

Inspired by a single page that @davidguttman made for the Mentorship meeting, I've built out bnb/join. I suppose could it be considered a tiny static site generator, but its purpose is to automatically build an index and individual redirect pages for every project defined in a JSON config file that can easily be deployed to GitHub Pages so we can have permalinks for each meeting.

Here's what the config looks like (and here's a link to the whole config):

    {
      "name": "Technical Steering Committee (TSC)",
      "filename": "tsc",
      "link": "https://zoom.us/j/611357642"
    },

And it builds (where nodejs is the GItHub org and join is the repo name):

  • A page called tsc.html, published to /docs. When used in conjunction with GitHub pages this would be published to https://nodejs.github.io/join/tsc. That link would redirect to whatever the value of link is in the object.
  • A list entry in the /docs/index.html file so if someone goes to https://nodejs.github.io/join they can launch from there.

You can see this at work right now:

For initial landing, this could simply be a repo in the org and we could use the nodejs.github.io/<repo> links. If we wanted to add something like meet.nodejs.org, meeting.nodejs.org/join, or join.nodejs.org we could very easily do that with a CNAME file/setting in the repo.

What problems does this solve? These are the ones that I see it solving:

  • One permanent link, forever. We won't have to switch Zoom links in calendar entries, in meeting automation tooling templates, nor anywhere else. If the Zoom link needs to be updated, it's a simple PR. If we move off of Zoom to whatever the next cool meeting platform is, we can update the link through tooling. This also enables project members to get this work done themselves without needing to ask a Calendar maintainer to do it for them.
  • Memorable links. The various options we have to implement this are all actually memorable, allowing us to lower the barrier to hopping on a call. It's a tiny improvement, but it's one I get caught on a lot. I'm generally a fan of reducing the burden on us as maintainers wherever possible 😊

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Review the existing bnb/join repository, especially template/meetings.json and its generated /docs pages, then assess how it could be transferred or recreated under nodejs/join or nodejs/meet. Confirm the GitHub Pages URL, redirect behavior, and optional CNAME approach; done means the organization has a maintained permanent meeting-link site with the configured meetings available.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
devops, infrastructure
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.