Это открытый проект, внести вклад в него может каждый. Контент и код Доки лежат на GitHub, правила участия, обсуждения и ревью проходят открыто для всех желающих.
Яндекс.Практикум поддерживает работу редакции Доки.
Как появилась идея Доки
Идея создать «добрую» документацию, в которой статьи будут написаны на понятном и несложном техническом языке, зародилась внутри Яндекс.Практикума в 2019 году. Тогда же появилась первая редакция и первые тексты. В конце 2020 года Дока стала активно развиваться, а 12 октября запустилась как независимый проект.
Осенью 2020-го ко мне пришёл Андрей Уродов из Практикума и предложил заняться проектом доброй документации для сообщества. Помню, меня тогда поразило слово «добрый», оно немного выпадало по смыслу, но когда я посмотрел на команду и подачу, я понял, о чём речь. Я всегда чувствовал эту болевую точку про источник знаний о веб-платформе и понимал, что это не просто безумная идея, а реальная потребность.
Я давно занимался «Веб-стандартами» — первым русскоязычным фронтенд-сообществом — и для меня это было понятным и интересным делом. Отдельно меня привлекла возможность поработать над опенсорсным проектом, в котором может принять участие любой желающий. Я подхватил эту идею и дожал её до полной открытости и публичности, чтобы проект не просто приносил пользу сообществу, но и развивался силами сообщества максимально прозрачно.Вадим Макеев,
главный редактор Доки
Зачем нужна Дока
Главная задача Доки — предоставить веб-разработчикам понятные справочные материалы на русском языке, которые хорошо и нескучно написаны. Дока может быть полезна и тем, кто учится разработке, и тем, кто уже работает. Начинающим разработчикам она поможет разобраться в терминах, а уже прокачанным ребятам даст возможность делиться опытом и обмениваться знаниями.
Дока — для тех, кому нравится веб-разработка. Кто хочет учиться и вдохновляться, кто хочет делиться знаниями, делать разговор вокруг технологий визуально наглядным, захватывающим, привлекательным.
Задача Доки — в том, чтобы помочь новичкам не разочароваться в себе и предмете. В том, чтобы разработчики с опытом знали место, где можно найти ответы на профессиональные вопросы. И в том, чтобы культура обмена опытом, диалога о программировании двигалась в сторону продуктивной простоты и соответствовала тому запросу, который давно на виду.Сергей Нугаев,
руководитель направления программирования в Яндекс.Практикуме
Помимо хорошей документации команда Доки планирует поддерживать и развивать сообщество веб-разработчиков. В планах — организовывать встречи и мероприятия, делать подкасты и видео для обмена знаниями.
Задача Доки — стать источником правды по веб-платформе для русскоязычного сообщества. В вебе есть много документации: от формальных спецификаций до развязных статей в личных блогах. Что найдёшь — тому и веришь. Как добавить свою каплю опыта в это море — не очень понятно. Плюс всё на английском языке, что становится не только барьером для тех, кто не знает язык, но и сдерживает тех, кто язык знает — нюансы часто теряются при чтении или переводе.
Другая сложность — как делиться опытом. Если напишешь пост в личный блог, даже на Хабр или Медиум, то высок шанс, что он потеряется со временем. Или даже хуже — не потеряется, но страшно устареет за пару лет. А тут можно так поделиться опытом, что это всегда будет на виду и любой сможет поправить то, что кажется некорректным.
главный редактор Доки
Как устроена Дока
Дока состоит из четырёх разделов: HTML, CSS, JavaScript и Инструменты.
В каждом разделе есть два типа статей. Дока — небольшая статья справочного характера. Статья — более объёмный материал, в котором автор рассуждает про какую-нибудь парадигму программирования, рассказывает о происхождении процесса, функции, тега.
Сейчас на сайте опубликовано 1011 статей.
Например, статья про grid
Команда проекта
Сейчас в команде 11 человек. Главный редактор проекта — Вадим Макеев, редактор разделов HTML и CSS — Алёна Батицкая, редактор разделов JavaScript и Инструменты — Николай Лопин, ревьюер разделов JavaScript и Инструменты — Саша Беспоясов, литературный редактор — Ольга Алексашенко.
Помимо редакторов, в команде Доки арт-директор Валя Броницкая, иллюстратор Кира Кустова, дизайнер Света Коробцева, бэкенд-разработчик Игорь Коровченко, фронтенд-разработчик Алексей Бузмаков и амбассадор в сообществе Егор Левченко.
Сотрудники Практикума стали вдохновителями проекта. Когда мы два года назад создавали программу по веб-разработке, то, во-первых, сами чувствовали нехватку в таком ресурсе, во-вторых, понимали, какую важную роль такой проект может сыграть и для сообщества, и для будущих разработчиков (которые сообщество дополнят).
Посмотрев по сторонам, поняли, что мы не одни с таким ощущением — так появилась команда, которая при поддержке Практикума довела проект до релиза. Основу команды составляет редакция. В начале, конечно, им пришлось многое сделать с нуля: собрать необходимую для запуска базу контента, сформировать редполитику, найти визуальный стиль, вплести в повествование инфографику и иллюстрации, сделать сайт. Параллельно мы показывали контент студентам Практикума, чтобы лучше понять, в правильную ли сторону двигаемся.
Теперь, после запуска, Практикум поддерживает независимую редакцию Доки, которая руководствуется своим желанием и целью сделать вместе с сообществом (и для сообщества) понятный, полезный и красивый справочник.
руководитель направления программирования в Яндекс.Практикуме
Как принять участие в проекте
Дока — это опенсорс-проект, любой разработчик может написать статью, предложить уточнения и правки, помочь с развитием платформы. На странице проекта на GitHub можно подробно прочитать, как присоединиться к работе над Докой.
Дока во многом — эксперимент, так что мы, конечно же, хотим понять, пригодимся ли мы сообществу, будет ли просто и полезно контрибьютить в такую опенсорсную документацию. Это понятно, любой новый проект немного сомневается. Но мы уверены, что нужно развивать контент, описывать веб-платформу шире и глубже, запускать новые разделы. У нас уже есть мысли про раздел SVG по векторной графике, про доступность. Ну и, конечно, мероприятия, которые помогут нас лучше узнать и научиться контрибьютить в Доку — митапы и хакатоны, которые мы запустим уже в ближайшее время.
главный редактор Доки
Следить за Докой можно в Телеграме, Твиттере, ВКонтакте, Фейсбуке.
Комментарии (85)
Saiv46
20.10.2021 12:44+3Ого, появилась альтернатива таким приложениям как https://devdocs.io/ и веб-справочкинам как https://webref.ru/
hisbvdis
20.10.2021 12:55+10Почему поддерживать опенсорсный и всемирно известный справочник MDN, переводя имеющиеся там статьи, хуже, чем создавать что-то своё?
Неужели статьи на MDN настолько "скучные", что пришлось писать новые "не скучные"?
pepelsbey
20.10.2021 13:02Мы поговорили в последних «Веб-стандартах» про Доку и там целая глава в конце: Почему не MDN. Если коротко: там нет авторов, туда нужно сразу писать на английском (это могут немногие), туда сложнее контрибьютить и дружелюбный, простой тон письма, который мы ценим в Доке, там поддерживать сложнее.
igsekor
20.10.2021 13:29Если есть Google, то зачем Bing? Если есть Bing, то зачем Yahoo? Если есть Yahoo, то зачем Яндекс? Если есть Яндекс, то зачем DuckDuckGo?...
Видимо, это ещё один способ. Проведите A/B тестирование. Дайте независимо новичкам MDN и Доку. Посмотрим, что будет удобнее. Скорее в всего, кому то придётся по душе одно, кому-то — другое.
hisbvdis
20.10.2021 13:40+1Наличие Bing никак не влияет на Google. По крайней мере, напрямую.
А вот силы, потраченные на наполнение отдельного сервиса, могли бы существенно улучшить уже существующий.
igsekor
20.10.2021 14:26+2Ошибаетесь, кстати. Напрямую влияет. Влияет на количество рекламы, которая могла бы быть заказана у Google, на оплачивается в Bing. В штатах очень даже популярный сервис, знаете ли. Google не дополучает довольно много денег, благодаря наличию конкурентов. Вы не готовы менять Google на что-то ещё, Вам и не нужен Bing. Но другим нужен.
Но это совсем не важно. Порог, который предлагают авторы MDN, сложно преодолеть большинству. Авторы MDN это почувствовали, кстати. Стараются улучшить их модель. Но нам-то это зачем? Зачем тащить легаси код, когда есть возможность писать сразу в рамках хорошего фреймворка?
Выбор подхода всегда обусловлен деньгами и временем для принятия и реализации решения компании. Нам понадобилось почти три года и множество упущенной личной выгоды, чтобы сделать новый фреймворк для документации. Мы смогли, нашли приемлемый вариант реализации и сделали дело. И сможем двигаться дальше. Уже не надо выбирать подход. Проблема такая уже не стоит, А Вы всё о ней говорите. То есть Вы говорите нам трёхлетней давности. Плюс к этому русскоязычное сообщество тоже надо развивать. А то останутся только недовольные окружающим миром снобы.
Вам жалко потраченных усилий? Наших усилий? Не жалейте нас и приходите в ишью и пары. Мы Вас ждём с большим удовольствием. Совсем не так, как ждёт Вас MDN.
LeshaRB
20.10.2021 13:00Почему название именно дока?
Не кажется, что слишком абстрактное название?
pepelsbey
20.10.2021 13:10Нам нравится :) Доки, спеки и вот такие простые слова говорят о том, что мы хотим быть проще и понятнее, чем обычные руководства.
AnonimYYYs
22.10.2021 11:13+1Странный выбор на самом деле. Особенно с учетом того, кем именно уже занято имя второй версии. Как будто человек, придумавший это даже не забил банально в гугл это слово (ну или в яндекс, whatever)
maledog
20.10.2021 13:04+6Так много пустого места и так мало полезной информации на экране. Этому сейчас web-разработчиков учат?
Пять слов (Поиск HTML CSS Javascript Инструменты) . Четверть площади экрана.
antytoto
20.10.2021 13:12Это вопрос скорее к дизайнерам, которые помогали создавать проект. Разработчиков учат скорее переносить дизайн в код.
igsekor
20.10.2021 13:34Правда классно, что хоть кто-то делает человеческие интерфейсы, а не дашборд?
valera5505
20.10.2021 14:11А чем блок 530x640 пикселей с 10 словами человечнее компактного интерфейса, где соблюден баланс между количеством информации на квадратный сантиметр экрана и свободным местом?
Скриншот
Также на сайте размер шрифта для текста под 29 пикселей, но при этом ощущение каши не покидает, когда видишь такую простыню
Скриншот
Рекомендую открыть отдельно в новой вкладке, а то при чтении из комментариев можно подумать, что вполне себе нормальный размер шрифта
dom1n1k
20.10.2021 14:14+5Ну справеливости ради, там действительно всё слишком крупно.
Вообще я люблю крупный читаемый текст, большинство сайтов использую в режиме 120-150%, коллеги бывает, видя мой монитор, говорят «ой как у тебя крупно» — так вот даже для меня ваш сайт слишком крупный, как детская книжка-картонка для взрослого. Такое ощущение, что 27-дюймовый монитор схлопнулся до ноута.igsekor
20.10.2021 14:38Как это говориться: «Откиньтесь на спинку кресла и читайте с удовольствием». Мы за правильную осанку! А вообще, надо нам поработать и над этим :)
ionicman
20.10.2021 13:26+1Ну как-бы разработчик должен уметь хотя-бы читать документацию и ещё желательно - понимать.
Документация на должна быть доброй, она должна быть понятной. А вообще уже хорошо, если она вообще есть. Тот-же MDN будет на порядок полезнее. И разработчик должен уметь искать и использовать любые крупицы информации.
Мы уже получили уйму "разработчиков" с Практикума, которые без stackoverflow даже hello word не способны сделать. Я так понимаю - это следующий виток?
Вообще, больше похоже на пр-проект, неужели что-то полезное для нормальных разработчиков, уж извините.
Куча пустого неорганизованного места, и евангелист Оперы, который не смог и подался в евангелисты веба и теперь главный редактор - это прям вишенка.
Как бы зло не звучало, но пр курсов и популяризация "легкого" веба для масс достала.
Лично моё ИМХО, никому не навязываю.
igsekor
20.10.2021 13:42+1Ну это просто чистой воды обесценивание иного пути. Да ещё и оскорбления. Глупо как-то...
zede
20.10.2021 13:27+2Концепт хороший. То что проект не забросят, я тоже уверен, но пожалуйста поправьте выбор цветов для темной темы. Я сам большой сторонник темных тем и она у меня стоит как предпочитаемая, да и вы не далекие от дизайна люди, как тогда вышло, что у вас абсолютно черный фон с абсолютно белым текстом.
Доки это место где разработчик достаточно долго работает с текстом и сочетание чисто черного с белым очень быстро утомит читателей.
Lopinopulos
20.10.2021 13:40+1Мы сейчас как раз обсуждаем изменения в темную тему. Приходи в ишью и вместе сделаем лучше ????
mtop
20.10.2021 14:08+2Автор, а другие разделы будут?.... по языкам там...
antytoto
20.10.2021 14:42+1Мы хотим максимально и полезно покрыть то, что есть сейчас.
Но проект принадлежит сообществу, если однажды сообщество решит, что вот прям надо-надо, и будет готово написать много полезного на эту тему, то почему бы и нет? Можно будет потом и посмотреть.
FireWind
20.10.2021 14:46+1А мне - понравилось. Что то подзабыл - глянул. Особенно полезно новичкам. Спасибо!
Alexandroppolus
20.10.2021 15:22+5По js, конечно, будет непросто превзойти знаменитый учебник learn.javascript.ru - там уж очень годно всё разобрано.
pepelsbey
20.10.2021 16:35+2Даже JavaScript.ru с чего-то начинался. Мы верим, что краудсорсинг позволит нам догнать и когда-нибудь перегнать многие справочники. Как минимум, по актуальности :)
GlazOtca
20.10.2021 16:03+2Спасибо, мне понравилось. Добавил в закладки. Надеюсь до PHP тоже дойдете. Всяческих успехов вам!
Lopar
20.10.2021 16:24+5Обычно я жалуюсь на сайты, что "мелко". Тут случай наоборот - прямо слишком крупно. У меня монитор 35 дюймов и что же? В это огромное пространство с огромнейшим трудом влезает один небольшой абзац текста. Часто к тому же ещё и неполный.
Так и запишем: экран на полстола, на котором с трудом помещается 10 строчек кода с парой строк описания. А эти адские отступы по краям. Не знаю, может с экрана какого-то макбука или смартфона это и выглядит красиво и компактно, но...
Или, захотел я найти например что-то по тэгу tr, но нет, нельзя. Чтобы найти что-то по tr надо искать или td или table. И. Интуитивно.
Нет такого тэга в этом сайте. Ой, есть, но только если искать не прямо его, а обходным путём. И снова, адские размерища всего этого на экране. На главной странице на один экран не влезают даже первые три заголовка статьи.
Заголовки с картинками. Это вроде как бы модно стильно молодёжно, но в самих статьях ты перестаёшь понимать куды ты попал и что происходит вообще. Ну то есть, ну ёпт..
Вот эта вот маленькая беленькая полосочка внизу: статья, которую я пришёл читать. Веб-дизайнеры за дизайном напрочь забывают про юзабилити. А иногда и про смысл происходящего. Как связан тэг <input> с чуваком жрущим сосиску и жирной надписью "сосиска", которая воспринимается как заголовок?
Вот эта разбивка на маленькие клочки информации более вредит чем помогает. Три страницы только по формам. Все страницы в примерах используют инпут. Перекрёстные ссылки? Не, не слышали.
Если это ориентация "для специалистов", то хочется прийти и получить информацию, а не прийти, войти в поиск, с удивлением открыть штук пять вкладок и с интересом выкусывать инфу то тут то там. Нет, это красиво, больше страниц, индекскация, не знаю, но всё в ущерб юзабилити, опять же.
Какие-то очень противоречивые чувства. Особенно на фоне десятков альтернативных сайтов с аналогичной +/- одинаковой обновляемой документацией.
flx0
20.10.2021 17:12-1Обычно я жалуюсь на сайты, что "мелко". Тут случай наоборот — прямо слишком крупно.
В вашем браузере не работает Ctrl+колёсико?
igsekor
20.10.2021 18:50+2Не вижу ни одной причины, чтобы не прийти в ишью. Помогите нам по-настоящему, профессионально, как Вы можете. Наверняка Вы принесёте много пользы :)
Насчёт интерфейсов — ну сложно это, сделать что-то действительно крутое и интересное. Это путь. Мы в начале этого пути. Аж зудит что-то исправить и улучшить. Нам важны мнения. А если эти мнения выражены в форме ишью — цены им нет!
qwazimord
20.10.2021 16:37+3Очень хорошо, что есть раздел инструменты! Особенно разделы по GIT и Docker. Цветовое решение и дизайн можно будет еще доработать, но главное - информация представлено наглядно.
uyrij
20.10.2021 20:58+2конечно плюс за https://doka.guide/js/async-in-js/ и другое полезное, но есть технические замечания - невозможно пользоваться с телефона - нет responsive подправьте свой собираемый из многих импортов css в разделе media query. И ещё один вопрос, а почему не readthedoc? Это тоже почти такой же Статик джемстэк как 11ty+netlify, но изкаропки сделан для документации. Могли бы захостить и в гитхабпейжес.
Lopinopulos
21.10.2021 11:55+2Мы рассматривали разные варианты, в том числе специально заточенные под документацию, типа GitBook, но все они либо не давали лёгкой возможности кастомизации, либо тащили свои процессы публикации. В общем, дьявол в деталях, которые не поменяешь.
В итоге мы решили развязать себе руки и выбрать самое гибкое решение.
uyrij
24.10.2021 00:22+2исправили css для смартов, прям быстро! и доделали темную тему, придётся добавить +. ????
hiperteksto
20.10.2021 22:30+1Большая часть команды разработки этого ресурса - из Нетология, во главе с Батицкой) Почему так?)
pepelsbey
21.10.2021 16:55+1Все участники редакции этого проекта выступают как независимые участники сообщества и не решают никаких задач компаний, в которых они работают. Так бывает, представляете? )
spasibo_kep
20.10.2021 23:08+1Хороший ресурс для ИТ-пиарщиков, чтобы проще вникать в матчасть, спасибо, Вадим и команда!
GooseOb
22.10.2021 11:14+1Пару часов назад только смотрел видос на канале Вадима, как сейчас уже в гугл discover увидел эту статью, прекол
Вадим крутой кста)
fs353
22.10.2021 11:14+2А я просто скажу 'Спасибо' за хорошую и главное актуальную информацию.
Ибо читая (как новичок) информацию на том же МДН, иногда теряю суть статьи за моментами перевода.
DivoTech
22.10.2021 15:59Извиняюсь, но у меня одного весит это огромное меню, которое занимает ровно половину экрана и его невозможно закрыть? Что на компе, что на мобилке. Как-то не очень для сайта про веб стандарты
Yser
23.10.2021 04:37+2Несмотря на название этот сайт имеет мало общего с документацией, в MDN я могу пробежаться по спеке и выхватить глазами какие-то места для фокусирования, здесь же больше мысль по древу, это больше похоже на w3schools
i360u
Я понимаю, что критиковать легко, и все мы тут такие токсичные профдеформированные снобы... Но я зашел, через пару секунд у меня вытек мозг и я сбежал. Зачем доки на русском, если одним из базовых скилов разработчика должно быть умение читать документацию на английском? Разве какой-нибудь https://developer.mozilla.org/ - не достаточно "добрый"? В общем, не понятно. Какой-то "дизайн проект", который, мне почему-то кажется, будет чужд многим инженерам.
P.S. Лого понравился. Клево.
antytoto
Спасибо за обратную связь =)
Документация на русском нужна, как минимум, для того, чтобы люди, которые пока ещё не выучили английский на достаточном уровне, могли вкатываться в разработку и уже чему-то учиться. Например, школьники, кто-то выбрал немецкий или французский и не имеет возможности учить английский прям вот сразу, но при этом хочет заниматься вебом.
Со временем, конечно, он выучит и английский, пойдёт почитать MDN, в спеку заглянет, но я считаю, что знание английского не должно быть препятствием для начинающих веб-разработчиков.
jack36
Вспоминаю историю как ко мне пришел один "чувачок" и утверждал, что он создаст русскоязычный код, который будет понятен любому человеку без знания английского и программирование.... Нуу.... такое уже создано - 1С программирование и он что, планирует создать новую архитектуру процессора? Ну как-то Сигма, Алмо, Бета, Рефал, Эль-76 или Рапира, как мне известно не зашли от слова совсем. Или российская операционная система Astra Linux, созданная на базе ядра Linux... - смешно же. Ну вы тем же самым бесполезным делом занимаетесь
Не хочу Вас огорчать, но если новичок вкатывается в программирование без знания английского хотя бы даже на школьном уровне B2, то шанс маленький, что и дальше выучит его. И это при том, что все компиляторы, конструкторы работают на английском языке и если его знать, то для львиной части конструкций даже не нужны будут инструкции. Все становится понятным.
По поводу проекта, исходя еще из статьи по обзору доки могу сказать, что такие проекты очень давно уже созданы, например тот же самый HTMLbook или WebRef.
Например статья об Apache в самом первом разделе о его настройке не содержит не одного намека на установку и настройку собственного Apache-сервера.
Структурированность в проекте совершенно отсутствует.
По мне Дока - это отличный пример того, как не стоит этого делать.
P.S. Подписавшись Яндекс.Практикум Яндекс пал еще ниже плинтуса и надежда на появление чего-либо разумного в России пропала окончательно....
pepelsbey
Мне кажется, что это скорее стокгольмский синдром, чем то, как всё должно быть на самом деле. А ещё ошибка выжившего :) Мы все настолько привыкли искать информацию по первоисточникам и что всё самое важное пишут на английском языке, что забыли о том, как важно обмениваться опытом друг с другом и о том, как себя чувствуют новички, когда сталкиваются с текстами на английском.
И тут дело далеко не только в английском языке, на том же MDN многие вещи объясняются сложнее, чем стоило бы. И почти нигде нет прозрачной схемы, как поправить существующую документацию, написать свою или поделиться опытом.
Всё это призвана решать Дока. Не бойтесь: можно говорить по-русски, можно говорить проще и можно делиться опытом на общей платформе. Даже нужно :)
i360u
Да, давайте окружим новичков любовью и заботой и превратим разработку в детский сад... Мне кажется, исходя из того, что я наблюдаю вокруг, что стоит двигаться как раз в обратном направлении.
igsekor
Давайте окружим. Мы же были лишены этой любви. Хорошее предложение. Мы уже сделали первый шаг.
То есть всё усложнять?
i360u
Не усложнять, держать приемлемый уровень на входе. Инженерная культура - во многом схожа с культурой обращения с оружием: она "написана кровью" (бессонными ночами, крупными сбоями, случайно удаленными данными и т.д.). Во всяком случае, не стоит создавать ложных впечатлений. Внимания достойны только те, кто прошел первичный отбор и способен "грызть гранит". Иначе от "вайтишников" гораздо больше вреда чем пользы. Люди совсем разучатся думать и отвечать за последствия своих действий.
igsekor
А зачем? Кому он нужен? Приемлемый уровень для одной компании один, для другой — совершенно иной. Рынок отрегулирует. А вот доступность знаний и навыков — это наш долг. Мы же должны передавать опыт, а не отбирать.
Кровью? А зачем все измазывать кровью? Зачем повышать градус стресса на ровном месте. В сущности, только вечные ценности действительно ценны. Все эти знания будут никому не нужны. Мы же идём к повышению уровня абстракции. Вы же видите.
i360u
Приемлемый для отношения "сигнал/шум" на рынке разработки. Для любой компании лишний шум создает только дополнительные накладные расходы. Кроме тех, кто зарабатывает на вайтишных курсах, конечно.
igsekor
Вы правильно сказали про С/Ш на рынке разработки. Но если и дальше пользоваться терминологией в рамках корреляционного приёма, есть четыре гипотезы. В двух из них всё прекрасно. Но есть и две другие — самые сложные. Приняли по ошибке, не приняли, а надо было принять. В первом случае есть возможность быстро выявить ошибку и просто устранить проблему. А вот второй случай — это ошибка компании. Если пользоваться Вашей пороговой функцией, то такие ошибки будут систематическими, к большой радости более проворных конкурентов.
Классическая механика тоже прекрасно существует, но спектр её применения сильно ограничен. Иногда нужна и квантовая, никуда не денешься.
i360u
Ошибки второго класса, про которые вы говорите, возможны только для той части спектра, которая уже предварительно ограничена первичным фильтром. В вайтишной зоне они просто статистически ничтожны, исходя из отношения множеств.
igsekor
Я про гармонические сигналы не говорю, они давно устарели. Только фазоманипулированные сигналы, работать с которыми намного сложнее, но алгоритмы оптимального приёма всё ещё вполне актуальны. Первичные фильтры, к сожалению, здесь не помогут.
Вайтишная зона — это тоже зона приёма, и принимать нужно сигналы и в этой части спектра. Вы же просто её фильтруете. Простой, но устаревший подход. Не для всех сигналов подходит.
i360u
Скажу по другому: вайтишный сигнал не только шумный, но и очень слабый. Накладные расходы на его обработку никогда не окупятся. Это все равно что просеивать песок на пляже в поисках золотых крупинок - конечно они там могут попадаться, но они никогда не окупят затрат на оборудование.
igsekor
А Вам никто не навязывает способы приёма. Вы же сами настраиваете свой приёмник. Пожалуйста. Мы же вообще для всех, кто жаждет знаний и опыта коллег.
Вы должны меня простить, ассоциация-то неправильная у Вас сложилась. Надо об этом говорить, а не о проблемах того, что некоторые компании или отдельные личности хотят денег, обманывая ожидания клиентов.
igsekor
Интересно, какой будет Ваша реакция, если к Вам придёт кандидат, Вы спросите его о том, где он читает доки, а он скажет, что в Доке. А если на MDN?
tundrawolf_kiba
Инфоцыганам, которые продают курсы «Вайти в айти», к примеру.
igsekor
А им этот уровень зачем? Они устанавливают тот, который доступен им.
Чтобы выбрать обучающие курсы надо многое пройти. Но ведь это просто услуга сейчас. Разве нет? Ненужные услуги и сами отомрут. Нужные — останутся. Но не бывает иначе.
В выговорите о том, что не нужно делать. А единственный ответ на вопрос «А что же тогда делать?» у Вас один — пробовать и читать доки на английском. Не кажется ли Вам эта позиция устаревшей? Надо ли этим путём, если есть другие? Зачем делать те действия, без которых раньше обойтись было нельзя, но сейчас запросто можно?
tundrawolf_kiba
Вы точно мне отвечали? Я, к примеру вот такого «В выговорите о том, что не нужно делать» не говорил. Это вообще мой первый комментарий в теме. Просто отвечал на вопрос — кому нужен больший порог для входа.
Затем, что, если вне курсов порог будет высоким — им проще будет продавать курсы.
igsekor
Ну да. Вы же указываете, чего нужно избегать. Ориентируюсь на контекст вопроса, на который Вы дали ответ.
Продавать им будет только сложнее, требования-то к услугам будут выше. Конкуренцию выдержат только те курсы, которые будут соответствовать спросу. Странный вывод.
pepelsbey
Я страдал, пусть все страдают. Ну такое )
StjarnornasFred
В английском языке есть слово motorist, которое переводится как "водитель" (имеется в виду - своего собственного автомобиля; driver и chaffeur - по работе). Почему такое слово? А оно, оказывается, родом из конца XIX-начала XX века, когда владение личным автомобилем требовало изрядных навыков в его обслуживании и ремонте. Со временем это ушло в прошлое, а слово осталось.
Это я к чему. Вам не нравится, что новички посягают на ваше любимое. Что внезапно оказалось, что разработка - это не техномагия для избранных, а нечто доступное всем желающим. Что можно быть не красноглазым хакером - в опять-таки первичном значении этого слова - а обычным пользователем, которому захотелось что-то освоить. Не больше чем курсы кройки и шитья. Вас это задело (как же так, я всю жизнь учился, у меня образование, а тут какие-то нубы... да как они смеют!) и вы пытаетесь сделать хоть что-то, чтобы помешать этому. Увы, не выйдет, прогресс не остановить.
Прогресс, между прочим, подразумевает повышение комфорта человека. Не ему нужно подстраиваться под условия окружающего мира, а, наоборот, окружающий мир при помощи технических средств подстраивается под него. Прекрасно, что теперь можно изучать документацию на том языке, на котором тебе удобно, а не на том, который волею незнакомых тебе людей назван основным и якобы стандартным.
И да. Русский язык - второй по распространённости язык в интернете. Русскоязычный сегмент интернета - самый развитый после англоязычного по числу собственных, а не глобальных, сервисов разного рода. В странах, в которых распространён русский язык, несмотря на упадок в остальных сферах развитие IT и цифровых технологий (включая сотовую связь, интернет-банкинг и прочее) находится на уровне не только не худшем, но и лучшем, чем в большинстве стран, где распространён английский язык. И, наконец, русский язык внесён ООН в число шести мировых языков. Так что не вижу ничего странного в том, чтобы документация была на русском языке, и тем более не вижу нужды искусственно городить языковой барьер для носителей столь распространённого в IT языка.
zantor
Китай молча рыдает в углу
dom1n1k
Аргументация ложная, потому что спутаны использование и ковыряние под капотом, простой юзер и профессионал. Что с автомобилем, что с компьютером порог входа для пользователя очевидно уменьшался, а вот для разработчика - скорее даже повысился, если смотреть в комплексе.
sunsexsurf
“Разработка - нечто доступное всем желающим». Если вы про хтмл/джаваскрипт - ну может быть. И то, даже там хорошо видно, что такое «ща я буду погромистом»: 100500 лишних зависимостей в проекте и неоптимизированные сайты, которые грузятся по 5 секунд и больше.
а уж если говорить про «разработку» как про энтерпрайз или что-то такое - ну вы серьезно тогда про Доку? Вы серьезно про «доступно желающим»? По вашей аналогии, скульптура - это тоже «доступно всем желающим». Только есть скульпторы (которые этому учились и имеют тонну практики), а есть «скульпторы», которые петухов из говна лепят.
А так - да. Ага. Доступно всем желающим.
П.С. Если че - не программист, аналитик данных. От моего кода у вменяемых людей слёзы бегут. ((
goddamm1t
Поддержу комментатора выше. Документацию лучше читать сразу на английском, даже если ты находишься на уровне london is the capital of great britain. Таким образом сформируешь привычку учиться на английском и научишься совмещать приятное с полезным.
pepelsbey
Да, язык нужно знать, чтобы читать первоисточники. Но если наше сообщество не может делиться опытом в рамках англоязычных справочников — мы запустили русскоязычный и опенсорсный. Попробуйте )
igsekor
Ну такой себе выход. Вот у меня всё время спрашивают о том, какую книжку почитать. И это большой конфуз, поскольку они почти все уже устарели на старте. А тут актуальная инфа, минимальное время на понимание. Может уже не будем тратить время разработчика на преодоление каких-либо порогов? Может сразу дадим то, чего разработчик желает?
alkresin
Английский разработчику, конечно, нужен. Но документация на родном языке нужна тоже, хотя бы потому, что ее быстрее читаешь и мозги при этом заняты исключительно самим текстом.
youngmysteriouslight
У меня, к примеру, учится советский человек верстать и, в целом, работать со связкой HTML+CSS+SVG. Не программист вообще, и не будет, разве что на уровне написания самых простых скриптов, но не факт. Английский не знает и учить нет смысла: общаться с англоязычными не будет, кроме как ради чтения документации и надписей в нелокализованных программах язык совсем не нужен, а затраты на обучения многократно превосходят затраты на гуглоперевод или чтоб дёрнуть меня. Так вот, хорошая русскоязычная документация высоко ценится, потому что доступна.
Получается какая-то языковая дискриминация. Я, конечно, понимаю, что можно закрыть на меньшинство, которое особо не влияет на экономику, но всё равно обидно получает.
TotalAMD
А пишет он как все теги, атрибуты и операторы? Просто заучил наизусть?
youngmysteriouslight
В начале перед глазами табличка тег/атрибут/значение — описание на русском языке.
Сейчас частоиспользуемые теги пишутся по памяти. Здесь работает принцип китайской комнаты: не обязательно знать, что в каком-то иностранном языке значит слово «border» или «solid», чтобы понимать, что этот атрибут и это значение позволяют нарисовать обычную рамку вокруг объекта.
kellas
Очень люблю доки на русском за то что там сразу выделяется код/операторы, которые на английском и в идеале термины которые не требуют перевода.
Так же и в коде для русскоязычных проектов, на уровня языка разделяются контент и управляющие конструкции / комментарии.
В использовании пары языков много плюсов
Если ты знаешь несколько языков, зачем ограничиваться одним
kost
* Кроме 1С.