Хто стоїть за Exercism?
У Exercism двоє співзасновників: Катріна Овен і Джеремі Вокер.
Exercism започаткувала Катріна, поліглотка-розробниця й лауреатка нагороди «Ruby Hero», яка випадково стала розробницею, здобуваючи ступінь з молекулярної біології.
Вона почала прискіпливо розбирати код ще 2006 року, коли волонтерила в JavaRanch, і це її затягнуло.
У програмуванні вона зосереджується на автоматизації, оптимізації робочих процесів і рефакторингу.
Вона щиро вболіває за відкритий код і долучається до кількох проєктів поза Exercism.
2016 року до неї як співзасновник долучився Джеремі, і нині він обіймає посаду генерального директора Exercism.
Джеремі - соціальний підприємець і розробник програмного забезпечення, який прагне рівності та створення можливостей для кожного.
Окрім Exercism, він співзасновник платформи для добробуту та командотворення Kaido.
Окрім цієї команди керівників, в Exercism є невелика команда штатних і частково зайнятих працівників, а також тисячі чудових волонтерів, які створили мовні треки та вправи, завдяки яким Exercism став таким популярним.
Дізнайтеся більше про наших наставників, супровідників треків і тисячі контрибʼюторів.
Звідки взялася назва «Exercism»?
Хоча назва відрізняється від «екзорцизму» лише однією голосною, вона не має нічого спільного ні з демонами, ні з виправленням «поганого коду».
Натомість це гра слів зі словом «exercise».
Катріна почала сприймати кожну вправу як маленьку, тривіальну й на перший погляд просту.
Однак коли доходить до розвʼязання вправи, диявол, як правило, криється в деталях.
Інакше кажучи, щойно ми замислюємося над дрібнішими деталями, ця проста вправа раптом стає складнішою.
Щоб дізнатися більше про те, що означає «диявол у деталях», подивімося доповіді Катріни Here Be Dragons і One Small Step.
Основи
Нічого не зрозуміло. З чого почати?
Пощастило.
Ось покроковий посібник, який допоможе зробити перші кроки.
Якщо щось усе ще залишається незрозумілим або не працює, ймовірно, з цим стикаються й інші, тож будемо вдячні за повідомлення про це на форумі.
Під час входу виникає помилка «Sorry, we could not authenticate you from GitHub». Що робити?
Це означає, що GitHub не готовий підтвердити особу.
Причина може бути в тому, що дозвіл не було надано, або в тому, що акаунт GitHub налаштовано неправильно.
Поширена проблема: адресу електронної пошти на GitHub не підтверджено.
Перевірити це можна в налаштуваннях електронної пошти GitHub.
Як видалити свій акаунт?
Видалити акаунт можна за посиланням унизу сторінки налаштувань.
Якщо проблема стосується листів і сповіщень, це можна змінити в особистих налаштуваннях.
Що потрібно зробити, щоб розвʼязати вправу?
Коли ми починаємо працювати над вправою, у нас є «заготовка рішення», яку потрібно доповнити, і повний набір тестів, що описує вимоги, яким має відповідати наше рішення.
Така методика розробки є формою розробки через тестування.
Як розблокувати вправи?
Типово треки з навчальними вправами вимагають розвʼязати навчальні вправи, щоб розблокувати інші (кожна з них має займати близько 5 хвилин, якщо мову вже знаємо вільно).
Це називається режим навчання.
Хоча радимо просуватися треком у режимі навчання, можна перемкнутися на режим практики, щоб розблокувати всі вправи.
Докладніше див. розблокування вправ.
Чому вправи, розблоковані на старому сайті, знову заблоковані?
Типово треки з навчальними вправами вимагають розвʼязати навчальні вправи, щоб розблокувати інші (кожна з них має займати близько 5 хвилин, якщо мову вже знаємо вільно).
Це називається режим навчання.
Режим навчання типово ввімкнений для всіх, хто користувався попередньою версією Exercism.
Тож ті, хто повертається, можуть виявити, що вправи, раніше доступні, тепер заблоковані.
Хоча радимо просуватися треком у режимі навчання, можна перемкнутися на режим практики, щоб розблокувати всі вправи.
Докладніше див. розблокування вправ.
Клієнт командного рядка Exercism
Не вдається надіслати рішення. Що робити?
Новий сайт має цілком новий клієнт командного рядка, а також потребує додаткових метаданих для вправи.
Прочитайте, як оновити клієнт командного рядка та перенести свої рішення на новий сайт.
Якщо це не допомогло або стара версія клієнта командного рядка не використовувалася, прочитайте посібник із клієнта командного рядка.
Якщо й це не допомогло, напишіть на форумі, і ми допоможемо все залагодити.
Як перевірити версію клієнта командного рядка?
Команда версії exercism version виводить поточну версію клієнта командного рядка Exercism.
Запустивши команду версії з прапорцем --latest, а саме exercism version --latest, можна перевірити, чи є новіша версія.
Як оновити клієнт командного рядка до останньої версії?
Команда exercism upgrade оновить клієнт командного рядка до останньої доступної версії, якщо така є.
Під час оновлення виникають помилки «permission denied». Що робити?
Якщо під час спроби оновити клієнт командного рядка виникають помилки «permission denied», найімовірніше, виконуваний файл було встановлено через системний менеджер пакетів (наприклад, Homebrew) або в каталог, до якого більше немає доступу на запис.
Якщо клієнт командного рядка встановлено через менеджер пакетів, для оновлення скористайтеся саме менеджером пакетів, а не командою exercism upgrade.
Якщо клієнт командного рядка встановлено вручну, перевірте шлях до клієнта командного рядка Exercism командою which exercism у Linux і MacOs та where exercism у Windows і переконайтеся, що повернений шлях указує на каталог, створений власноруч.
Якщо це так, засобами системи змініть права доступу до каталогу, надавши своєму користувачеві доступ на запис, і спробуйте оновитися ще раз.
Якщо немає впевненості, що каталог створено власноруч, або повернений шлях є системним, видаліть клієнт командного рядка засобами системи та встановіть його заново за інтерактивним посібником.
Після оновлення у Windows зʼявляється діалог помилки «16-bit MS-DOS Subsystem». Що робити?
У версіях клієнта командного рядка Exercism до 3.0.5 команда оновлення мала ваду: вона замінювала виконуваний файл клієнта на один текстовий файл, що й спричиняло помилку «16-bit MS-DOS Subsystem».
Щоб виправити це, видаліть пошкоджений виконуваний файл і встановіть клієнт командного рядка заново за інтерактивним посібником.
Режим наставництва
Черга давно не оновлювалася. Щось не так?
Час очікування може бути довшим за звичайний із багатьох причин (кількість наставників, пора року), а крім того, може здаватися, що черга не оновлюється.
Це не дивина, і незабаром у черзі має зʼявитися рух.
Якщо очікування набагато довше за середнє, див. Створення звернення нижче.
Скільки наставників має мій трек? На сайті видно лише кількох.
Сайт показує лише тих наставників, які заповнили інформацію про себе, а не фактичну кількість наставників, які активно переглядають рішення.
Запевняємо: наставники розбирають свої черги, тож наберімося терпіння!
Надіслано не те рішення чи файл. Що робити?
На сторінці відповідної вправи перейдіть до розділу «Ваші ітерації».
Якщо непотрібна ітерація згорнута, натисніть стрілку в кружечку.
У меню «три крапки» виберіть «Видалити ітерацію».
Як повідомити про зловживання або неякісне наставництво?
Докладніше про наші очікування щодо поведінки читайте в Кодексі поведінки.
Якщо хочете про щось повідомити, напишіть нам на abuse@exercism.org, і ми спробуємо виправити чи залагодити це, з повагою до особи та приватності.
Чому не вдається залишити відгук про представлення?
Щоб залишати відгуки про представлення для треку, потрібно відповідати трьом критеріям:
- Бути наставником цього треку
- Провести щонайменше 100 завершених обговорень для цього треку
- Мати загальний рейтинг задоволеності щонайменше 95%
Як покращити Exercism
Це чудово! Як долучитися?
Є кілька способів: стати наставником, керувати мовним треком або повідомляти про звернення на GitHub (чи навіть братися за них!).
Більше на сторінці «Як долучитися».
Як на сайт додаються нові мовні треки?
Новий мовний трек зʼявляється, коли хтось зі спільноти береться за це й стає супровідником треку.
Щоб долучитися до створення нового треку, є інструкції тут.
Як повідомити про проблему
Якщо помітили щось не так, повідомте про це, створивши тему на форумі.
Перш ніж створювати тему, обовʼязково пошукайте наявні обговорення.
Спробуйте кілька різних ключових слів.
А якщо моєї проблеми немає ні тут, ні на форумі?
Якщо проблему ще не вирішено й не повідомлено про неї, створіть нове повідомлення на форумі.
Обовʼязково додайте таку інформацію:
- Вивід команди
exercism troubleshoot (для проблем із клієнтом командного рядка)
- Подробиці про проблему, з якою зіткнулися
- Вказівки, як відтворити проблему
- Якщо доречно, посилання на повʼязане звернення за його номером (у форматі #1203)
А якщо проблема стосується мови на сайті?
Якщо проблема стосується вправи в мовному треку, знайдіть потрібний мовний трек у цьому списку і створіть там звернення.
Зазначте, чи проблема стосується інструкцій, чи чогось суто мовного, скориставшись наведеним нижче шаблоном.
Якщо помітили одруківку або маєте пропозицію, як зробити мову чи інструкції на сайті загалом зрозумілішими, створіть нову тему на форумі з такою інформацією:
- Посилання на сторінку, де є проблема
- Пояснення, у чому полягає помилка або що незрозуміло
- Запропонована зміна
