Browse Source

isntructions for self audits during coronavirus in english and russian

content-update
Christopher Fremond 4 years ago committed by Christopher Fremond
parent
commit
0bd0154988
  1. 92
      subjects/audits-at-home.en.md
  2. 83
      subjects/audits-at-home.ru.md

92
subjects/audits-at-home.en.md

@ -0,0 +1,92 @@
## How to do an audit from home
### Introduction
A little reminder first,
Audits, as we have told you many times, are an essential part of leveling up and truly acquiring your skills
and knowledge.
Normally, they must be done with your physical presence.
The idea is that they encourage the exchange between the auditors and the members of the group.
If the project fails, the whole group will learn why. And then after all your audits are done you will retry.
During all those extra audits, you, as a group, will discuss about your failures with the auditors.
If the project succeed, you will be an inspiration for the auditors.
In both of those cases you will learn or you will teach. The roles will keep reversing almost every time.
It is, ultimaly, those interactions that are essential for really learning;
To give and receive feedback, but also to see what you really know as an individual and what you do not.
This will increase your capacity to solve problems and your capacity to adapt, which is one of the most important
skill of a good programmer.
Today, once again, we must adapt...
Knowledge is important but not as essential as health.
We really wish all of you to stay safe and healthy at home.
This is why we created a little guideline in how to conduct your audit from home.
There is a video here : https://www.youtube.com/watch?v=J8g8P-IJLJw
But we are also going to summarize the process.
So here we go.
### Prerequisites for the team captain and the auditor
- A program to communicate and livestream installed (like Discord https://discordapp.com/ )
- A program to allows the auditor to take charge of the computer
of the team captain installed (like teamViewer https://www.teamviewer.com/ )
### Prerequisite for the team captain
The team captain must communicate :
- The contact of his or her teammates to the auditor
- The git repository of the project to be reviewed (the link must be public or accessible for the auditor)
- The team captain must be logged in in his or her session to allow the auditor to start its audit
### Prerequisite for the auditor
- The auditor will need to create the group on the communication program
- The auditor will need to download the project repository
- The auditor, if the internet bandwith allows it, will livestream the process
### Instructions
1. Let the auditor establish the communication with the group members and the captain.
2. Once all prequisites are done from the team captain and the auditor let the audit begin.
3. If possible, the auditor starts the stream.
4. The captain, after checking that the login is done on his or her computer, allows the auditor
to take control of its computer (with teamViewer for example)
5. The auditor now has the control to start the audit on the computer of the captain.
The organization of the windows by the auditor might be the tricky part. We suggest
to see how we did it in the video if you find it difficult.
6. The auditor conducts the audit, if the auditor can not live stream its audits, he or she
will then explain by voice (or writing in the chat) what he or she is doing to the rest of the group.
7. The audit is conducted until all questions are validated or until a mistake is made.
8. If a mistake is made the auditor can copy paste the commands that detected the mistakes.
9. The group discusses as much as needed until the audit is completed.
10. Once the audit is completed, all programs can be closed up. Say bye and thank you for your time and make the
necessary conclusions among the members of the group.
### Conclusion
Thank you for reading until the end. Stay safe.
### Bonus
Did you know that there is a nice `Live Share` extension on `vscode`?
This allows to do remote group programming easily. It might be an alternative solution
to the livestream if necessary.
Try it out!
Stay safe everyone! Happy coding!

83
subjects/audits-at-home.ru.md

@ -0,0 +1,83 @@
## Как проводить аудиты удаленно
Сначала небольшое напоминание,
Аудиты, как мы неоднократно говорили, являются неотъемлемой частью вашего обучения и получения реальных навыков.
Обычно они должны проводиться оффлайн.
Идея состоит в том, что это способствует обмену знаний между аудиторами и членами группы.
Если проект провалится, вся группа будет знать точную причину. И после того, как все ваши проверки будут выполнены, вы попытаетесь сдать еще раз, с новообретенными знаниями.
Во время всех этих дополнительных проверок вы, как группа, будете обсуждать с аудиторами ваши недочеты.
Если проект будет успешным, вы будете вдохновлять аудиторов.
В любом случае вы будете либо учиться или либо учить кого-то. Роли учителя/ученика меняются почти каждый раз.
Это, в конечном счете, те взаимодействия, которые необходимы для реального обучения;
Давать и получать отзывы, а также видеть то, что ты действительно знаешь, а что нет.
Это улучшит вашу способность решать проблемы, вашу способность адаптироваться, что является одним из наиболее важных навыков хорошего программиста.
Сегодня мы снова должны адаптироваться ...
Иметь знания конечно хорошо, но здоровье важнее.
Мы действительно желаем всем вам оставаться дома в безопасности.
Поэтому мы разработали небольшое руководство по проведению аудита из дома.
Ссылка на видео: https://www.youtube.com/watch?v=J8g8P-IJLJw
Также, можете прочесть:
### Необходимые вещи для коммуникации аудитора и капитана команды
- Программы для коммуникации и стрима (Discord подойдет)
- teamViewer или что-то похожее чтобы дать аудитору доступ к вашему компьютеру
### Что нужно сделать капитану:
- Собрать команду перед аудитом.
- Дать аудитору доступ к git, либо сделав репу публичной, либо сделав аудитора коллаборатором
- Залогиниться в платформе чтобы аудитор начал проверку
### Что нужно сделать аудитору:
- Договориться с командой на счет времени проверки
- Скачать репу проекта
- Стримить процесс проверки команде
### Инструкции
1. Аудитор договаривается на счет времени проверки с командой
2. Как только все будет готово, начинает проверку
3. Если возможно, аудитор запускает стрим, чтобы команда видела саму проверку.
4. Капитан, зайдя на платформу, разрешает аудитору взять под контроль свой компьютер (TeamViewer)
5. Теперь аудитор может запустить проверку на компьютере капитана.
   Организация окон со стороны аудитора может быть сложной частью. Мы предлагаем
   посмотреть видео, и узнать как мы это сделали.
6. Аудитор проводит проверку, если аудитор не может в прямом эфире транслировать свою проверку, он или она
   затем объяснит голосом (или в чате), что он или она делает и как проверяет.
7. Аудит проводится до тех пор, пока все вопросы не верны или пока не будет допущена ошибка.
8. Если проект сломался на каком-либо тесте, аудитор может показать команде при каком тесте произошла ошибка.
9. Группа обсуждает потенциальное место ошибки столько, сколько необходимо, до завершения аудита.
10. После завершения аудита все программы могут быть закрыты. Скажите пока и спасибо за ваше время и сделайте
    необходимые выводы среди членов группы.
### Conclusion
Спасибо, что дочитали до конца. Оставайтесь в безопасности.
### Bonus
Знаете ли вы, что есть хорошее расширение `Live Share` в` vscode`?
Это позволяет легко выполнять дистанционное групповое программирование. Это может быть альтернативным решением
для прямого эфира, если это необходимо.
Попробуйте!
Будьте в безопасности! Удачного кодинга!
Loading…
Cancel
Save