Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Study Groups page could use more instruction #1140

Open
JoeStrout opened this issue Jul 24, 2019 · 1 comment
Open

Study Groups page could use more instruction #1140

JoeStrout opened this issue Jul 24, 2019 · 1 comment
Labels
Backlog [feature] hangouts issues that relate to the hangout functionality [tech] html resolution is likely to involve HTML

Comments

@JoeStrout
Copy link

JoeStrout commented Jul 24, 2019

I found my way to the Study Groups page, and clicked Learn More to get the pop-up, but it seemed to be assuming I was already familiar with Jitsi.

In fact I had never heard of Jitsi, and had no idea what software was depicted in the diagram until a helpful CB user on Slack filled me in. And now, having downloaded Jitsi, I still can't figure out how to use it — apparently, unlike all other conferencing software I've used, it doesn't have its own servers; you must instead connect to some other service.

If Jitsu is sort of a community standard, a brief paragraph about this (or at to least name it and link to some external docs) would be helpful.

@lpatmo
Copy link
Member

lpatmo commented Jul 25, 2019

Thank you for filing this issue, @JoeStrout!

To clarify, are you talking about the "Learn More" popup here?

image

I'd love to brainstorm ways in this issue about how we could improve the copy in that popup so that it's clear that a "Jitsi iframe hangout" is immediately embedded onto the page when someone creates a hangout on codebuddies.org/hangouts, and the user doesn't have to download an extra app called Jitsi.

Maybe we shouldn't even mention the word "Jitsi" in the content on the popup.

The current copy:

You can start three types of Hangouts:

 Silent Hangout
 Teaching Hangout
 Collaboration Hangout
You can you start a Hangout on any topic you want, and you do not need to be an expert on it in order to start one. Unlike most Hangout experiences you may be used to, we typically turn off the video in all of our Hangouts.



A  Silent Hangout is like a virtual coffeeshop for people who want to be productive. You can make the Hangout topic general enough so that people can work on different things, or the topic could be about working through the same tutorial or coding exercises. As a Silent Hangout host, you can decide to do a quick microphone-on check-in near the end of the session, but in general participants will expect the majority of the Hangout to be microphone-off.

A  Teaching Hangout functions as a space where you can teach a concept or walk participants through a codebase. This is your way of sharing your knowledge and your skills!

If you create a  Collaboration Hangout, you can use the Hangout as a space to "pair program" on a coding exercise, talk through a chapter of a coding tutorial together, or work on an open-sourced project with anyone who might be interested.

How do I get my Hangout noticed?
When you schedule a Hangout, it will automatically get posted to CodeBuddies' twitter feed at @codebuddiesmeet, to the #announcements channel on Slack, and to any Slack channels linked with the group your hangout is scheduled under. (Only group owners can link Slack channels under the "Settings" tab in their group.)

Our community is most active on Slack; we recommend that you figure out a time that works for at least one other study partner, and then schedule the Hangout for that time. When you've created the Hangout, feel free to share a link to it in any relevant Slack channel so that others who didn't see it can join.

When a Hangout is in progress, what are some general tips?
Hangouts are a safe space for learning with participants of all levels. Please follow our community's Code of Conduct.
It's all right to join a Hangout late, or to be a silent observer. You're not interrupting! If you'd rather not speak, please remember to type "hello" in the chatbox so that the other participants in the Hangout knows you're there and observing.
You can use Slack OR the Hangout chat box to chat and type questions.
Screensharing is always optional, but it's a useful tool for preventing ourselves from getting distracted by Facebook or YouTube during a Silent Hangout, or for tracking where everyone is at in a tutorial, or for debugging someone's issue more easily during a  Teaching or Collaboration Hangout.
Hangouts lets multiple people screenshare with each other at the same time. You can click on a person's individual icon to see their screen.
Note: We now allow you to use an external third-party URL that replaces the default Jitsi room when you schedule a hangout, like Zoom or Twitch.

@lpatmo lpatmo added [feature] hangouts issues that relate to the hangout functionality [tech] html resolution is likely to involve HTML labels Jul 25, 2019
@lpatmo lpatmo added the Backlog label Oct 9, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Backlog [feature] hangouts issues that relate to the hangout functionality [tech] html resolution is likely to involve HTML
Projects
None yet
Development

No branches or pull requests

2 participants