rolling-scopes-school/docs

docs's Issues

Инструкция для тренеров - "Как стримить лекции на YouTube канал The Rolling Scopes "

@davojta Согласился помочь с этим документом
Дедлайн - 1 апреля.

[Cross-Check Fancy-Weather] - 'Alex89889'

1. https://alex89889.github.io/fancy-weather/
   2)Не реализована возможность голосового поиска по названию населённого пункта – 20 баллов
   Не реализован перевод текста страницы (en/ru/be) – 20 баллов
   Не реализована возможность переключения единиц измерения температуры – 10 баллов
   Итого: - 50 баллов
2. 73

[Translation] Angular course

Translate the following article:
https://github.com/rolling-scopes-school/docs/blob/master/docs/angular-course.md

Баг в списке работ на cross-check fancy-weather

В списке проверок формально 2 студента, т.к. вторая ссылка дублирует работы одного и того же человека, причем неверно указана ссылка - не на деплой, а на ветку в приватном репозитории.

Добавить к "Требования к оформлению коммитов и PR" конкретные примеры

Из фидбека:

Пожалуйста, добавьте в "Требования к оформлению коммитов и PR" 
конкретные примеры, какие типы коммитов использовать в каких случаях,
 а то пока непонятно: добавка кода в HTML - это feat или что?
 Добавление в css (или изменение в css) - это feat, style или fix? 
Добавление или изменение файлов с изображениями или шрифтами - это какой тип? 
Очень нужны примеры! Спасибо!

Требования к выполнению тасков в RSSchool stage#2

[Translation] Fix typo

Translate the following article:
https://github.com/rolling-scopes-school/docs/blob/master/docs/fix-typo.md

Единый JavaScript Style Guide для всех тасков Stage#2

Комментарии приветствуется

Отдельный курс по TS/Fullstack

Идеи:

• месячный курс наподобие http://learn.javascript.ru/courses/nodejs
• ожидается, что слушатели уже знают JS

Тут собираем идеи как можно улучшить сross-check процесс

[Translation] First home task

Translate the following issue:
https://github.com/rolling-scopes-school/docs/blob/master/docs/first-home-task.md

[Translation] React course

Translate the following article:
https://github.com/rolling-scopes-school/docs/blob/master/docs/react-course.md

Автоматизированное тестирование тасков

Всем привет!
Выношу на обсуждение и предложение сделать автоматическую проверку тасков.

Это будет удобно менторам и студентам.
Ментор, проверяя ваш таск может запустить тесты, если тесты не проходят - то всё, досвидания и даже проверять не надо и ему сразу по результатам наших тестов будет понятно что студент сделал.
Студент, пытаясь удовлетворить тестам, во первых, будет писать возможно более качественное приложение, во вторых научится работать и узнает что такое Test Driven Development (TDD), и также у него будет наглядная картина результата куда нужно стремится.

И это не отменяет того момента что и студентам нужно будет писать свои тесты. Тестирование это хорошо. Т.к. когда студент поймёт что его код невозможно протестировать никак кроме снапшотов, тогда он научится писать функции меньше, чище и лучше.

Итак, посмотрев на сайте FreeCodeCamp как у них сделаны таски и проверка, почему мы хуже?)

К примеру у них есть такое задание: https://learn.freecodecamp.org/responsive-web-design/responsive-web-design-projects/build-a-survey-form , где описаны UserStory и внизу дана ссылка на тест-раннер https://cdn.freecodecamp.org/testable-projects-fcc/v1/bundle.js который проверяет выполнение таска в автоматическом режиме.
Я набросал этот таск в codepen: https://codepen.io/medinsky/pen/PvGMqK
Посмотрите как удобно иметь такую тест-систему, как она работает.

где мы можем выбрать таск , который проверяем

и чтоб не мешалась, её можно свернуть

в случае, если какой-то тест завалился, то мы получаем хороший фидбэк от тест-системы

в общем, как будет у меня времени побольше, я постараюсь набросать нечто подобное для авто-тестов таска CV к примеру. Конечно если есть добровольцы которые могут снять эту задачу с меня, это тоже хорошо т.к. время иногда сложно выкроить

Фокус на TypeScript

Все большее и больше менторов RSSchool используют TS на продакшн проектах.
В связи с этим предлагаю изменить учебную программу stage#2 заменив часть лекций/заданий на аналогичные таски с использованием TypeScript

[Translation] How to enroll

Translate the following article:
https://github.com/rolling-scopes-school/docs/blob/master/docs/how-to-enroll.md

Реализовать возможность подтягивать оценки в score напрямую из PR

Варианты:

• Chrome extension
• GitHub web hooks
• ????

[Cross-Check Portfolio] - dermeister

1. Deploy - https://jovial-jepsen-269ba4.netlify.com/
2. Repo - https://github.com/dermeister/portfolio
3. 100 баллов - все сделано согласно заданию
4. Балл за cross-check из Score - 88

обновить доки по стримингу с указанием регистрации за 2 дня

необходимо указать порядок регистрации НОВОГО акка для стриминга

https://docs.rs.school/#/streaming?id=%d0%9a%d0%b0%d0%ba-%d0%bd%d0%b0%d1%81%d1%82%d1%80%d0%be%d0%b8%d1%82%d1%8c-%d0%b8%d0%bd%d1%81%d1%82%d1%80%d1%83%d0%bc%d0%b5%d0%bd%d1%82%d1%8b-%d0%b4%d0%bb%d1%8f-%d1%81%d1%82%d1%80%d0%b8%d0%bc%d0%b8%d0%bd%d0%b3%d0%b0

[Translation] JS FE course

Translate the following article:
https://github.com/rolling-scopes-school/docs/blob/master/docs/js-fe-course.md

[Cross-Check Portfolio] - nextdesusu

1. https://stupefied-edison-c78870.netlify.com/
2. https://github.com/nextdesusu/portfolio
3. Оцениваю работу примерно в 90 баллов, каких то значимых недочетов не нашел, но мне кажется они есть, плюс не уверен в мобильной версии.
4. Текущий балл 66.

[Translation] Final task

Translate the following article:
https://github.com/rolling-scopes-school/docs/blob/master/docs/final-task.md

[Translation] Node.js course

Translate the following article:
https://github.com/rolling-scopes-school/docs/blob/master/docs/nodejs-course.md

[Cross-Check Fancy-Weather] - 'Christopher-0118'

1. https://brave-curie-d28cbd.netlify.com/
2. Оценка в результате самопроверки студентом:
   ошибка верстки. Один блок не стал на место, поэтому перекрывает другой -5.
   т.к. реализован только базовый уровень максимальный балл 80 баллов
   Итого: 75 баллов
3. 0 баллов
   У меня не выставлена оценка по кроссчеку потому что ждала, когда третий студент мне ответит и задеплоит свою работу, чтоб я могла её проверить. А пока ждала его работу, то не поставила никакого балла. =(
   т.е. из трех работ были проверены 2, но т.к. последний студент связался со мной после дедлайна я так и не поставила отметку 0 в скор.
   Могу ли я в таком случае получить какой-то балл или все же уже поздно?

[Cross-Check Portfolio] – 'gitmaxx'

1. https://mx-portfolio.netlify.com/
2. https://github.com/gitmaxx/portfolio
3. Оценка: 98 баллов. Штраф 2 балла за отсутствие плавной анимации
4. 75 баллов

Пересмотр оценки, в случае если студент исправил замечания

Собираю предложения, что необходимо сделать ментору, если студент исправил замечания?

1. Что должен делать студент с замечаниями ментора?
2. Можно ли пересмотреть оценку, если студент исправил замечания
3. Что делать если студент исправил, например, ошибки eslint? вкомитал функционал, который не был реализован к дедлайну?
4. ...

Определить скоп, для которого студенты должны писать юнит тесты при выполнение заданий

Варианты:

• тестируем только чистые функции. Например, минимум 3 чистые функции должно быть протестировано
• тестируем то, что попросил тестировать ментор
• просто написать 10 любых тестов

[Cross-Check Fancy-Weather] - 'vladimir-drachuk'

1. Ссылка - https://vladimir-drachuk.github.io/fancy-weather/
2. • есть ошибки при поиске (не продумал согласование API определения местоположения и API прогноза погоды, например при введении в строку слова "Рим" - API местоположения ссылается на итальянский Рим в то время как прогноз погоды приходит из какого-то российского города) - срабатывает крайне редко, нашел только один город) - 15;

• typeerror в консоли если заходить впервые(при чистом localStorage) - 5;

3. 190;
   P.S отправил issue по причине того, что у одного студента не открылось стартовое окно(видимо не убрал баннер рекламы и не сработало API местоположения), из за этого было выставлено только 50% работы.

Как улучшить документацию http://docs.rs.school

Буду рад любым комментариям, замечаниям, исправлениям

[Cross-Check Portfolio] - moiseenokv

1. https://moiseenokv.github.io/portfolio/
2. https://github.com/moiseenokv/portfolio/
3. max score (64/100

• Minuses:
  • 1. Failure to adapt page for both desktop and mobile sizes may result in losing up to 40 points. -30
  • 2. No links to to my private social profiles - 3
  • 3. No animation in education block -3

4. 0

Нумерация в rs code of conduct

Дмитрий, есть идея находить(фиксировать, отмечать) базовые случаи (думаю их не много и латинского алфавита для их обозначения вполне хватит, в крайнем случае можно применить натацию: n, N, n1 и т.п.) и далее писать к ним инструкцию например:
n (ментор не выходит на связь) - решение: попробуйте то-то и то-то
d (студент вовремя не сдал работу) - решение: в общем случае понижение балла и т.п.
далее путем комбинации подобных условий или ситуации можно достаточно лаконично объяснить что произошло и найти решения в идеале все это можно было бы скормить боту например или написать тот самый FAQ все таки время идет и скоро новый набор:smirk_cat: 

Правила хорошего тона студентов RSSchool

Фидбек от ментора

У меня просьба, обозначить студентам, что номер телефона и соответсвенно 
мессенджеры, типа телеги - это крайний способ связи,  достаточно заассайнить реквест, немного пригорело, что мне пишут в час ночи с вопросом, а буду ли я сразу проверять или нет

• ставить Star проектам, которыми пользуетесь
• говорим спасибо в канале #gratitude или в RSSchool APP, если вам помогли
• ....

Информация будет добавлена в https://github.com/rolling-scopes-school/docs/blob/master/students.md

[Cross-Check Portfolio] - Artur1986ad

1. https://artur1986ad.github.io/My-portfolio/
2. https://github.com/Artur1986ad/My-portfolio
3. Данный task проверили 3 студента. И я в том числе тоже проверил у 3 студентов работу, и при этом в score 0 баллов . Но по отзывам студентов там не может быть 0 . Скорее всего произошел сбой, либо объясните почему в score 0 баллов
4. 0 баллов.

Переход от отдельных md файлов к структурированной документации

Предлагаю реализовать "документацию в виде сайта" на базе текущего набора md файлов.
Пример, как должен выглядеть результат - https://lodash.com/docs/4.17.11

Основные фичи:

1. Вся документация выглядит как единый файл
2. Можно перейти к конкретному разделу (Например, https://lodash.com/docs/4.17.11#noop)
3. Версионирование документации
4. Консистентный перевод (все переводы представляют одну версию документации)
5. Глоссарий терминов RSSchool
6. ...

Что забыл?
Какие варианты по тех-стеку для реализации?

[Cross-Check Portfolio] - 'Qairkhan'

1. https://qairkhan.github.io/portfolio/
2. https://github.com/Qairkhan/portfolio
3. Оценка: ~ 85 . отсутствует описание
4. 0 - видимо, были проблемы с сабмитами

[Cross-Check Fancy-Weather] - 'bacila1990'

1. https://nostalgic-dijkstra-95628e.netlify.com
2. Не реализован перевод текста страницы (en/ru/be) – 20 баллов
3. 67

[Cross-Check Fancy-Weather] - 'AnzhelaMartsinovich'

1. Ссылка на диплой вашего проекта
   https://martsinovich-anzhela.netlify.com/

2. Оценка в результате самопроверки студентом
   Не реализован перевод текста страницы (en/ru/be) – 20 баллов
   Присутствуют ошибки в консоли на любом этапе работы приложения – 10 баллов
   Итого: 180

3. Балл за cross-check из вашего Score - 165

[Cross-Check Portfolio] - Dziazhurny

1. https://dziazhurny.github.io/Portfolio/
2. https://github.com/Dziazhurny/Portfolio
3. Minuses:
   Education panel:
   (-3) Smooth animation.
   Projects carousel
   (-6) Interactive image in description (or whole description). When clicked, you should be navigated to project page.
   Projects swiper
   (-3) Project image should have all available width.
   (-6) When the description button is clicked, it should show the description overlay above the image. And name near the button should switch text to 'hide description'.
   (-6) Interactive image in description (except button and its label). When clicked, you should be navigated to project page.
   Project page:
   (-3) 2 buttons exist on desktop version.
   (-3) When you are on desktop, and click 'mobile', the view should be switched to centered mobile one and margins on left and right. Name of button should be changed properly. Second click will revert project to desktop view again.
   (-3) When you are on desktop, and click 'back', you should be navigated to original portfolio page.
   (-3) Only 1 button exists on mobile version.
   (-3) When you are on mobile, and click 'back', you should be navigated to original portfolio page.
   Total: 100 - 39 = 61
4. Point for cross-check: 0.

[Cross-Check Fancy-Weather] - SkynerSany

1. https://skynersany.github.io/weather/
2. Верстка прототипа приложения не адаптивная и не резиновая - 20
   В блоке 4 не отображаются широта и долгота - 10
   При изменении города не меняется дата и время - 20
   Не реализована возможность голосового поиска - 20
   Смена языка реализована на 50% - 10
3. 0

Cертификат RSSchool 2.0

• Определить и прописать минимальные требования для получения сертификата
• Разделить сертификат на 2 части
  • первую часть человек получает после окончания обучения
  • вторую часть получает после окончания менторинга в одном из циклов RSSchool
• Переработать дизайн
• Что необходимо указывать на сертификате?
  • пройденные таски, интервью?
  • благодарности от других студентов?
  • фио ментора?
• ???

Алгоритм взаимодействия ментор-студент во время проверки задания

Алгоритм взаимодействия ментор-студент во время проверки задания:

1. Студент выполняет задание в приватном репозитории
2. Студент создает и оформляет Pull Request.
   • Правила оформления PR указаны ниже.
   • Штрафы за нарушения дедлайна указаны ниже. При применении штрафных коэффициентов, округление происходит в пользу студента.
3. До выставления финальной оценки ментором, студент может продолжать реализовывать фичи после дедлайна со штрафом 50% к их стоимости в баллах.
   • Названия коммитов должны явно говорить о реализованной фиче.
   • Студент должен оставить отдельный комментарий в открытом Pull Request о функционале, который был реализован и его стоимости в баллах с учетом 50% штрафа.
   • При применении штрафных коэффициентов, округление происходит в пользу студента.
4. Ментор проверяет PR, оставляет свои замечания и рекомендации по качеству кода (copy-paste, magic numbers, project structure, etc.) и реализованной функциональности. Указывает предварительную оценку в комментарии.
   • Оценка выставляется ментором на основании критериев оценки указанных для каждого задания.
   • При выставлении оценки учитывается весь реализованный функционал. Например, студент выполнил минимальные требования не на 100 процентов, но выполнил часть дополнительных - все требования должны учитываться.
   • Ментор может выставить предварительную оценку авансом, с учетом того, что студент исправит все замечания ментора.
5. Студент в течении 3х дней исправляет замечания ментора.
6. По результатам исправления ментор выставляет окончательную оценку в Score RS APP.
   • Ментор сам решает снимать баллы или нет за правки после дедлайна.

[Cross-Check Portfolio] – Juliya-Potapchuk

1. https://juliya-potapchuk.github.io/portfolio/
2. https://github.com/Juliya-Potapchuk/portfolio
3. Минусы:
   -Слайдер не бесконечный – 5 баллов
   -Недоделанный адаптив страницы под моб. устройства – 7 баллов
   -Нет перехода на страницу ‘repair-design-project’ – 5 баллов
   -Неплавная анимация – 5 баллов
   -Аватар должен лежать в папке ‘assets’– 5 баллов
   Все требования по слайдеру были выполнены, за исключением того, что он должен быть цикличен. Главная страница адаптивна, но не до конца. После 407px появляется горизонтальная прокрутка. Нет перехода на страницу проекта ‘repair-design-project’. Ввиду того, что данное задание не было мною выполнено, соответственно, добавить переход на несуществующую страницу я не могу. Однако, несмотря на это, на главной странице в десктопной версии присутствует изображение проекта и место для его описания, а в мобильной предусмотрена кнопка с выпадающим описанием проекта. Что касается неплавной анимации и расположения изображения в папке ‘assets’, то в изначальных требованиях данных пунктов не было, появились они на момент проверки уже готовых заданий.
   Итого: 100 -5(слайдер) -7(адаптив) -5(‘repair-design-project’) =83
4. Балл за cross-check: 53.

Создать\Интегрировать курс английского с программой RS school

Идея состоит в том, что бы организовать на курсе RS School параллельное изучение\практику английского языка. Пока из идей следующее:

1. Сотрудничать со школой иностранных языков по принципу аудитория <> выгодные предложения.
2. Объединиться с некоммерческими организациями, которые проводят собрания типа English club
3. Организовать собственный курс: каждый набор в RSS встречаются люди с хорошим знанием английского. Они могли бы стать двигателем прогресса в смысле pay it forward - они могут вернуться не только в роли ментора, но и в роли english активиста. Помочь разработать программу \ собрания \ интерактив.

Улучшение системы менторства в RSSchool

Всем привет!

Собираю идеи как можно сделать систему менторства в RSSchool лучше/интереснее/эффективнее/понятнее и т.д.

Актуальные темы:

• совместный менторинг
• открытый профиль (такой, чтобы было можно приаттачить в CV, пошарить на подобие linkedin, и т.д.)
• как более эффективно расходовать менторские ресурсы?

Буду рад любым предложениям

[Cross-Check Fancy-Weather] - 'jetalai3'

1.Ссылка на диплой вашего проекта
https://cranky-carson-5bc711.netlify.com/

2.Верстка только под мобильники -15
Итого 195

3.Балл за cross-check из вашего Score - 162

Один из проверяющих каким-то образом не сумел правильно открыть приложение и поставил 100 баллов из 210 возможных.

CodeJam PiskelClone Refactoring

Тут собираем идеи/гайдлайны/принципы/ по которым студенты должны будут отрефакторить код PiskelClone (или использовать при решении связанных с ним codejam тасков)

[Translation] Employment

Translate the following article:
https://github.com/rolling-scopes-school/docs/blob/master/docs/employment.md

Отдельный курс по React Native

• TBD

Синхронизация переводов для discussion rules

Старые варианты:

# Chat rules
## Main chat - [Discord](https://discord.gg/bek4WMb)
## Channels
**#announcements** - important notifications for students.  
**#general** - main text channel about everything.  
**#questions** - general questions.  
**#gratitude** - if you want to thank someone. Our mentors will notice this).    
**#materials** - slides, books etc only, no discussions.  
**#english** - use this in case you want to discuss some task in English. There’s a separate [server](https://discord.gg/mZdYun6) for general English practice where we chat about everything.  
**#fun** - memes etc.  
**#moderation** - ban notifications, notes about moderation etc.  

## Rules  
* Official languages: EN, BE, RU.  
* If you see a channel for some specific RSS task - use it instead of **#questions**. Don’t post unrelated content, for example, **#live-coding** channel is intended __only__ for discussing questions during live streams. Non-related stuff will be deleted.  
* Use search and pinned messages.  
* Reply with mentioning (@nicknamehere).  
* Be polite, don’t troll too hard, and you’ll be ok.  


# Правілы чату
## Галоўны чат - [Discord](https://discord.gg/bek4WMb)
## Каналы
**#announcements** - важныя абвесткі.  
**#general** - галоўны канал "пра ўсё".  
**#questions** - галоўны канал для пытанняў.  
**#gratitude** - сюды пісаць падзякі тым, хто дапамог. Ментары пабачаць гэта).    
**#materials** - слайды, кнігі і г.д, без абмеркавання.  
**#english** - use this in case you want to discuss some task in English. There’s a separate [server](https://discord.gg/mZdYun6) for general English practice where we chat about everything.  
**#fun** - мемасікі.  
**#moderation** - усё звязанае з мадэрацыяй.  

## Правілы  
* Афіцыйныя мовы: EN, BE, RU.  
* У выпадку калі існуе асобны канал для пытанняў па нейкім заданні - трэба выкарыстоўваць яго, а не **#questions**. У канале абмяркоўваецца толькі тэматыка пазначаная ў назве, напрыклад, **#live-coding** прызначаны __выключна__ для абмеркаванняў live-стрымаў. Нетэматычныя пасты будуць выдаляцца.  
* Трэба карыстацца пошукам і pinned messages.  
* Адказваць чалавеку пажадана праз mention (@nicknamehere).  
* Будзьце ветлівымі, не заходзьце занадта далёка з тролінгам, і ўсё будзе добра.  

Форматирование сообщений

Добавить раздел "Форматирование сообщений" в
https://github.com/rolling-scopes-school/docs/blob/master/ru/discussion-rules.md

• Пару примеров из официальной документации
• Пару примеров оформления вопросов к заданиям - Блоки кода/Картинки и тд.

RS School Webpack Config

[Cross-Check Fancy-Weather] - 'Victoria-Butrym'

1. https://confident-goodall-1aae22.netlify.com/
2.

• Реализован поиск. Если в поиске вводится корректный запрос, все данные на странице, в том числе дата и время, обновляются в соответствии с указанным в поиске населённым пунктом: -30 (дата и время не обновляются)
• фоновые изображения генерируются с учетом поры года, времени суток, текущей погоды: -10 (генерируется только с учетом местности)
• Реализована возможность переключения единиц измерения температуры: -5 (после поиска не меняется)
• Реализована возможность голосового поиска по названию населённого пункта: – 20
• Реализован перевод текста страницы (en/ru/be): – 20
• ошибки в консоли на любом этапе работы приложения: – 10

3. 97