Move bnb/join to nodejs/join or nodejs/meet
Nobody has claimed this yet.
- 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 tohttps://nodejs.github.io/join/tsc. That link would redirect to whatever the value oflinkis in the object. - A list entry in the
/docs/index.htmlfile so if someone goes tohttps://nodejs.github.io/jointhey can launch from there.
You can see this at work right now:
- Any of the following links work:
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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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