Skip to content

Open source курс по основам программирования от «Хорошего программиста»

Notifications You must be signed in to change notification settings

aristofun/rubyrush

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

93 Commits
 
 
 
 
 
 
 
 

Repository files navigation

RubyRush

Open source курс по основам настоящего программирования для всех и каждого. Основной язык — Ruby. Здесь хранятся все уроки и задания курса.

🎓
Лично Вы, дорогой читатель можете внести свой вклад в этот курс (об этом ниже).

Как устроено

На данный момент из содержимого этой репы middleman-ом генерится статический сайт на https://rubyrush.ru со временем переедем на свой движок, сохранив общую структуру и место хранения курса.

В папке steps/ лежит линейный список «шагов».

Каждый шаг это урок с вложенными в него видосами и/или текстом, или ДЗ, или какой угодно mardkdown+html материал.

Последовательность шагов на сайте в конечном итоге определяем мы, деплоеры курса (@aristofun, @installero).

Структура папок

steps/<step_slug>/ — уникальное имя (идентификатор) шага.

Шаги-ДЗ принято привязывать к соотв. уроку и нумеровать.

Например после урока steps/classes-inheritance есть 2 ДЗ: steps/classes-inheritance-01 и steps/classes-inheritance-02.

Файл Его смысл
/<step_slug>/content.md основное тело шага
/<step_slug>/links.json ссылки и материалы к шагу
/<step_slug>/files/* файлы для материалов к уроку
/<step_slug>/solution/* код с ответом на ДЗ

links.json

Отрывок из steps/argv-test/links.json — шаг-урок про аргументы командной строки

{
  "help": [
    {
      "title": "Тест на логическое мышление",
      "url": "http://syntone.ru/psytesty/test-logicheskogo-myshleniya/"
    },
    {
      "title": "Тонкости работы с командной строкой Windows",
      "url": "http://habrahabr.ru/post/218759/"
    }
  ],
  "materials": [
    {
      "title": "Работа с аргументами запуска",
      "url": "arguments.rb"
    },
    {
      "title": "Тест на ревнивость",
      "url": "jealous_test.rb"
    }
  ]
}

"help" — абсолютные ссылки на актуальные материалы к теме урока (мануалы, полезные статьи, читшиты...)

"materials" — имена файлов относительно вложенной в этот же шаг папки steps/argv-test/files/. Ссылка сгенерится напрямую на репозиторий с этим файлом.

Этот файл внутри любого шага (ДЗ, урок) актуален и используется, если есть.

content.md

Содержит хорошо структурированный текст шага (урок или ДЗ). Может содержать вложенные по определенному формату видео и спец. блоки с ДЗ/подсказкой.

Просто сравните внимательно:

https://github.com/aristofun/rubyrush/edit/master/steps/argv-test/content.md

и

https://github.com/aristofun/rubyrush/blob/master/steps/argv-test-01/content.md (шаг-ДЗ)

Решения ДЗ

Решения ДЗ, код, файлы и пр. надо складывать в подпапку соотв. шага (пример №1, пример №2).

В виде подпапки с набором файлов проекта, а не архивом.

Как вносить вклад

🎁

Исправления

  1. Увидели на сайте https://rubyrush.ru какой-то косяк или слабое место
  2. Нашли по слагу соотв. папку тут
  3. Сделали пулл-реквест с улучшениями
  4. PROFIT!

Новые уроки

  1. Увидели что какая-то тема рассказана плохо или не рассказана вообще
  2. Или вспомнили интересную задачку для начинающих
  3. Свяжитесь с @aristofun, @installero чтобы согласовать тему
  4. Пулл-реквест
  5. PROFIT!!

PROFIT

  1. Cсылки на самых активных контрибьюторов разместим тут, на самом сайте и вообще при любом случае поддержим и упомянем.
  2. К карме +150 каждый пулл-реквест

Время разбрасывать камни и умножать добро 🎈

И через это еще больше прокачиваться. Кто на себе хоть раз проверял, знают о чем я.

License & copyright

Воровать и использовать без нашего ведома никакие материалы нельзя, навсегда испортите карму. Все вопросы решим, пишите.

About

Open source курс по основам программирования от «Хорошего программиста»

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published