Я поговорил с Сашко Стубайло, разработчиком ядра Meteor, о его текущем проекте:

Роберт: Вы работаете над новым проектом под названием Путеводитель по метеорам. Что это?

Сашко: Руководство будет состоять из примерно 15 статей, каждая из которых будет посвящена определенному аспекту создания приложения в Meteor. В настоящее время я работаю над этим с Томом Коулманом, который недавно присоединился к Meteor и является одним из авторов Discover Meteor. Мы также пытаемся сделать что-то довольно крутое с этим проектом, а именно, мы собираемся разрабатывать его полностью в открытом доступе на GitHub от начала до конца. Цель состоит в том, чтобы каждый мог быть проинформирован о процессе, если он заинтересован, и никого не удивит контент, когда он будет официально выпущен.

Давайте поговорим немного больше о контенте — чтобы привести два примера статей, которые мы могли бы написать, одна будет о формах, пользовательском вводе и проверке, а также одна о том, как создать функциональность учетной записи пользователя в вашем приложении. Идея состоит в том, чтобы сосредоточиться на том, чего люди пытаются достичь с помощью Meteor, и объяснить наиболее распространенные задачи в этих темах в понятной форме. Так что на самом деле это не учебное пособие для начинающих, и это также не продвинутый, передовой ресурс, а скорее сборник лучших практик. Я очень впечатлен Rails Guides, так что это был бы хороший шаблон, на который можно посмотреть, к чему мы хотим прийти.

Роберт:Почему вы решили создать это руководство?

Сашко: Ну, одна из причин в том, что есть так много мест, где скрыта информация о Метеоре. У вас, конечно, есть docs.meteor.com, но у вас также есть вики-статьи, файлы чтения пакетов, сообщения в блогах и многое другое в разных местах. Я хочу создать место, где информация организована по тому, что вы пытаетесь сделать, а не по типу технологии или тому, где кто-то случайно опубликовал ее. Вы не начинаете с «Я действительно хочу использовать для этого метод Meteor». Вы начинаете с чего-то вроде «Я хочу добавить форму в свое приложение, и я хочу, чтобы оно проходило проверку». Такие темы могут быть сложными. Для проверки вам может потребоваться проверка в реальном времени, пока пользователь печатает, другой вид проверки при отправке и еще один на сервере. Разработчики должны знать обо всех инструментах, необходимых им для создания отличного приложения, но сейчас нет единого места, где можно найти эту информацию.

Еще один фактор заключается в том, что я не думаю, что Meteor проделал большую работу по продвижению пакетов сообщества. Документация Meteor не должна включать только пакеты, написанные MDG. Он должен включать в себя все, что вам нужно для создания приложения. Meteor не является полной структурой без всех пакетов сообщества. Нам нужно место для документирования не только самого Meteor, но и большого мира проверенных пакетов, которые используют многие люди.

Роберт: один уважаемый мной разработчик сказал, что Meteor отлично подходит для начинающих и действительно продвинутых людей, но люди среднего уровня или те, кто только начинает изучать базовые демоверсии Meteor, находят большой пробел, где действительно не так много практических советов.

Сашко: Да, именно для этого и предназначен Путеводитель по Метеорам. Это не для человека, который впервые пробует Метеор, и не для кого-то вроде Аруноды, потому что он, наверное, мог бы написать все это сам! Это для людей посередине, которые говорят: «Хорошо, я сделал урок. Что теперь?" Одним из вариантов было купить такую ​​книгу, как Discover Meteor, но вы, возможно, не захотите читать всю книгу последовательно. Для этого требуется довольно много времени. Лично я не любитель просто читать книги от начала до конца. Другое дело, что это стоит денег. Вам не нужно платить кому-то, чтобы изучить основы того, как вы должны использовать Meteor.

Роберт: В Discover Meteor очень удобно создавать приложения, и вы получите большую часть того, что вам нужно знать. Лично я не нашел его столь же хорошим с эталонной точки зрения. Я не возвращаюсь к нему, чтобы узнать, как делать подписки, потому что подписки находятся в контексте приложения.

Сашко: Да, и контекст книги также вынуждает автора вписывать все содержание в какой-то мастер-нарратив. Руководство не будет иметь этих ограничений. Если есть какой-то контент о подписках, который мы не добавили, мы можем просто добавить еще один раздел внизу. Это очень гибко.

Роберт:Итак, каковы ваши планы по его развитию и как вы видите роль ЦРТ и сообщества? Как люди могут способствовать этому?

Сашко: Думаю, сейчас мы где-то на стадии обсуждения первоначальных идей и набросков контента. Я думаю, что важно начать с того, какой контент будет нужен людям, а не с того, какой контент легко написать, потому что на некоторые пункты в плане, который мы создали, очень сложно ответить. Это хорошо, потому что это выявит пробелы, в которых мы должны оказать помощь.

Роберт: На самом деле вы продвигаете дискуссию о дырах в экосистеме Meteor или, по крайней мере, о знаниях людей о Meteor.

Сашко: Верно. Если в нашем наброске есть маркер, и на самом деле нет хорошего способа написать этот код, это звучит как пробел, который кто-то должен заполнить, будь то ЦРТ или член сообщества. Или, может быть, теперь, когда этот пробел очевиден, кто-нибудь может написать для него пакет. Каталога этих пробелов никогда не существовало. Конечно, в репозитории Meteor есть куча проблем и запросов на добавление функций, но сложно расставить приоритеты по сравнению с тем, что действительно нужно людям, поэтому, надеюсь, это может быть шагом в правильном направлении.

Роберт: Да. Это интересно, на самом деле. Кто-то с амбициями расти в сообществе Meteor может на самом деле искать дыры, места в руководстве, где нет решения или не очень хорошее решение, и они могут на самом деле ориентироваться на это как на что-то, чтобы либо создать продукт вокруг, либо получить свои руки. грязный в экосистеме Метеор.

Сашко: Верно. Любая из справочных статей или даже маркеров может быть отдельным учебным пособием. Мы, вероятно, не собираемся углубляться, по крайней мере, в первой версии, по каждой теме. Мы просто будем такие: «Вот мнение. Вот несколько примеров кода. Надеюсь, вы сможете понять, как применить это к другим вещам». Кто-то мог пойти туда и сказать: «Хорошо, я думаю, это немного сбивает с толку», и написать целую 10-шаговую инструкцию только об этом одном. Мы можем дать ссылку на него. Это было бы круто.

Роберт: Да. Что-нибудь еще, что мы должны попытаться охватить? Что мы должны сказать, что мы хотим, чтобы люди знали об этом?

Сашко:Итак, если люди хотят подробнее узнать о планах проекта, присоединиться к обсуждениям на разные темы или внести свой вклад, начав новые разговоры, им следует обратиться к метеору/гиду. на Гитхабе. Там у нас есть доска прогресса статьи, устав, в котором излагаются видение и цели проекта, некоторые краткосрочные планы и множество замечательных обсуждений по проблемам.