Commit 2e8ce16b by francisco

linting videoconference and communications

parent 640ea9fc
Pipeline #48220 passed with stage
in 3 minutes 5 seconds
...@@ -9,64 +9,53 @@ The specific Bluejeans address for classes will be shared with the Nodes when th ...@@ -9,64 +9,53 @@ The specific Bluejeans address for classes will be shared with the Nodes when th
Simultaneous videoconferencing among many remote users is essential for Fab Academy. This system allows people to talk directly to all the other participants, including Professor Neil Gershenfeld, and ask questions during our Wednesday lecture sessions. Simultaneous videoconferencing among many remote users is essential for Fab Academy. This system allows people to talk directly to all the other participants, including Professor Neil Gershenfeld, and ask questions during our Wednesday lecture sessions.
### Necessary Hardware / Connectivity ### Necessary Hardware / Connectivity
* Internet access (recommended at least 1MB upload/download speed) * Internet access (recommended at least 1MB upload/download speed)
* Webcam (or one built into your computer) * Webcam (or one built into your computer)
* Echo-canceling USB speakerphone * Echo-canceling USB speakerphone
### Video Conferencing Etiquette - IMPORTANT! ### Video Conferencing Etiquette - IMPORTANT!
Because everyone connected can hear each other, it is vital that you are muted when joining a conference. By default, you'll be muted in the platform and so remember to UN-MUTE (ONLY) WHEN SPEAKING Because everyone connected can hear each other, it is vital that you are muted when joining a conference. By default, you'll be muted in the platform and so remember to UN-MUTE (ONLY) WHEN SPEAKING.
Failure to mute will cause a disruptive feedback echo that will SERIOUSLY interfere with the audio quality, making class unpleasant. Neil can see who is the source of the problem and will mute you, so failure to mute is potentially embarrassing. Practice connecting prior to class. Failure to mute will cause a disruptive feedback echo that will SERIOUSLY interfere with the audio quality, making class unpleasant. Neil can see who is the source of the problem and will mute you, so failure to mute is potentially embarrassing. Practice connecting prior to class.
Similarly, make sure that your camera is on and that all class participants are visible (if possible). Light the participants from the camera side and eliminate back lighting as much as possible, so everyone connected can see you. Similarly, make sure that your camera is on and that all class participants are visible (if possible). Light the participants from the camera side and eliminate back lighting as much as possible, so everyone connected can see you.
## Communications ## Communications
Every Fab Academy cycle is organized in our [Fabcloud](https://gitlab.fabcloud.org/academany/fabacademy) and named after the year. Every Fab Academy cycle is organized in our [Fabcloud](https://gitlab.fabcloud.org/academany/fabacademy) and named after the year.
This helps us collect all projects in a single place, host the Fab Academy and Fab Lab Network's websites and provide a tool for collaboration and communication between people and labs. This helps us collect all projects in a single place, host the Fab Academy and Fab Lab Network's websites and provide a tool for collaboration and communication between people and labs.
We use [Gitlab](https://about.gitlab.com/) to organize all the content related to Fab Academy in a distributed way. We use [Gitlab](https://about.gitlab.com/) to organize all the content related to Fab Academy in a distributed way.
### What we do with Gitlab?
**What we do with Gitlab?** Keep all student files under version control; track groups of students, labs, instructors and staff; publish the Fab Academy website; publish and host lab and student pages; publish documents like this Handbook; track what needs to be done and communicate using Issue trackers; take meeting notes using [Markdown](https://www.markdownguide.org/); and build sites and documentation using static site generators.
Keep all student files under version control; track groups of students, labs, instructors and staff; publish the Fab Academy website; publish and host lab and student pages; publish documents like this Handbook; track what needs to be done and communicate using Issue trackers; take meeting notes using Markdown; and build sites and documentation using static site generators.
So, every Fab Academy cycle students are added as Member to the following Gitlab Groups: So, every Fab Academy cycle students are added as Member to the following Gitlab Groups:
Academany > Fab Academy > Your year of enrollment > Your Lab > Your Lab Instructor Groups `Academany > Fab Academy > Your year of enrollment > Your Lab > Your Lab Instructor Groups`
So students can both Document and Publish their work, and Communicate with the rest of the group. This communication happens through Issue Trackers. So students can both Document and Publish their work, and Communicate with the rest of the group. This communication happens through Issue Trackers.
All of these concepts will be explained to you on the first class’ sessions. All of these concepts will be explained to you on the first class’ sessions.
**What is an Issue Tracker?** ## What is an Issue Tracker?
The GitLab Issue Tracker is an advanced and complete tool for tracking the evolution of a new idea or the process of solving a problem. [Gitlab Docs](https://docs.gitlab.com/ee/user/project/issues/) The GitLab Issue Tracker is an advanced and complete tool for tracking the evolution of a new idea or the process of solving a problem. [Gitlab Docs](https://docs.gitlab.com/ee/user/project/issues/)
It allows communications between the different groups (students, Instructors, Faculty, Global Evaluators) within the Fab Academy structure easier and more organized. It allows communications between the different groups (students, Instructors, Faculty, Global Evaluators) within the Fab Academy structure easier and more organized.
Students will be able to: Students will be able to:
* Communicate with the class / Replacing emails
* Communicate with the class / Replacing emails
* Track your personal tasks (in your projects) * Track your personal tasks (in your projects)
* Use them as Kanban boards * Use them as Kanban boards
* Assign issues to milestones * Assign issues to milestones
### Communication's Etiquette ### Communication's Etiquette
When using the Class Project, every member of the class (students, Instructors, Faculty, Global Evaluators) will receive an email notification each time somebody submits or comments an Issue. For this reason, please be cautious in the way you use this tool: When using the Class Project, every member of the class (students, Instructors, Faculty, Global Evaluators) will receive an email notification each time somebody submits or comments an Issue. For this reason, please be cautious in the way you use this tool:
* Users should first discuss their questions with their Local Instructor or Remote Guru if possible, before posting an Issue * Users should first discuss their questions with their Local Instructor or Remote Guru if possible, before posting an Issue
* Users should first check if the question/problem/comment was raised before in the Issues List * Users should first check if the question/problem/comment was raised before in the Issues List
* Close issues when the question/problem/comment is answered/solved/received. Remember to add SOLVED to the title. It will help other finding solutions
* Close issues when the question/problem/comment is answered/solved/received
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment