From 0bd0154988244f63be7ffbb79d0626ed5e3a6b98 Mon Sep 17 00:00:00 2001 From: Christopher Fremond Date: Wed, 22 Apr 2020 19:18:51 +0100 Subject: [PATCH] isntructions for self audits during coronavirus in english and russian --- subjects/audits-at-home.en.md | 92 +++++++++++++++++++++++++++++++++++ subjects/audits-at-home.ru.md | 83 +++++++++++++++++++++++++++++++ 2 files changed, 175 insertions(+) create mode 100644 subjects/audits-at-home.en.md create mode 100644 subjects/audits-at-home.ru.md diff --git a/subjects/audits-at-home.en.md b/subjects/audits-at-home.en.md new file mode 100644 index 00000000..c042c03d --- /dev/null +++ b/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! diff --git a/subjects/audits-at-home.ru.md b/subjects/audits-at-home.ru.md new file mode 100644 index 00000000..b068af1e --- /dev/null +++ b/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`? +Это позволяет легко выполнять дистанционное групповое программирование. Это может быть альтернативным решением +для прямого эфира, если это необходимо. +Попробуйте! + +Будьте в безопасности! Удачного кодинга! \ No newline at end of file