Comments 86
Я понимаю, что критиковать легко, и все мы тут такие токсичные профдеформированные снобы... Но я зашел, через пару секунд у меня вытек мозг и я сбежал. Зачем доки на русском, если одним из базовых скилов разработчика должно быть умение читать документацию на английском? Разве какой-нибудь https://developer.mozilla.org/ - не достаточно "добрый"? В общем, не понятно. Какой-то "дизайн проект", который, мне почему-то кажется, будет чужд многим инженерам.
P.S. Лого понравился. Клево.
Спасибо за обратную связь =)
Документация на русском нужна, как минимум, для того, чтобы люди, которые пока ещё не выучили английский на достаточном уровне, могли вкатываться в разработку и уже чему-то учиться. Например, школьники, кто-то выбрал немецкий или французский и не имеет возможности учить английский прям вот сразу, но при этом хочет заниматься вебом.
Со временем, конечно, он выучит и английский, пойдёт почитать MDN, в спеку заглянет, но я считаю, что знание английского не должно быть препятствием для начинающих веб-разработчиков.
Вспоминаю историю как ко мне пришел один "чувачок" и утверждал, что он создаст русскоязычный код, который будет понятен любому человеку без знания английского и программирование.... Нуу.... такое уже создано - 1С программирование и он что, планирует создать новую архитектуру процессора? Ну как-то Сигма, Алмо, Бета, Рефал, Эль-76 или Рапира, как мне известно не зашли от слова совсем. Или российская операционная система Astra Linux, созданная на базе ядра Linux... - смешно же. Ну вы тем же самым бесполезным делом занимаетесь
Не хочу Вас огорчать, но если новичок вкатывается в программирование без знания английского хотя бы даже на школьном уровне B2, то шанс маленький, что и дальше выучит его. И это при том, что все компиляторы, конструкторы работают на английском языке и если его знать, то для львиной части конструкций даже не нужны будут инструкции. Все становится понятным.
По поводу проекта, исходя еще из статьи по обзору доки могу сказать, что такие проекты очень давно уже созданы, например тот же самый HTMLbook или WebRef.
Например статья об Apache в самом первом разделе о его настройке не содержит не одного намека на установку и настройку собственного Apache-сервера.
Структурированность в проекте совершенно отсутствует.
По мне Дока - это отличный пример того, как не стоит этого делать.
P.S. Подписавшись Яндекс.Практикум Яндекс пал еще ниже плинтуса и надежда на появление чего-либо разумного в России пропала окончательно....
Мне кажется, что это скорее стокгольмский синдром, чем то, как всё должно быть на самом деле. А ещё ошибка выжившего :) Мы все настолько привыкли искать информацию по первоисточникам и что всё самое важное пишут на английском языке, что забыли о том, как важно обмениваться опытом друг с другом и о том, как себя чувствуют новички, когда сталкиваются с текстами на английском.
И тут дело далеко не только в английском языке, на том же MDN многие вещи объясняются сложнее, чем стоило бы. И почти нигде нет прозрачной схемы, как поправить существующую документацию, написать свою или поделиться опытом.
Всё это призвана решать Дока. Не бойтесь: можно говорить по-русски, можно говорить проще и можно делиться опытом на общей платформе. Даже нужно :)
Да, давайте окружим новичков любовью и заботой и превратим разработку в детский сад... Мне кажется, исходя из того, что я наблюдаю вокруг, что стоит двигаться как раз в обратном направлении.
Давайте окружим. Мы же были лишены этой любви. Хорошее предложение. Мы уже сделали первый шаг.
То есть всё усложнять?
Не усложнять, держать приемлемый уровень на входе. Инженерная культура - во многом схожа с культурой обращения с оружием: она "написана кровью" (бессонными ночами, крупными сбоями, случайно удаленными данными и т.д.). Во всяком случае, не стоит создавать ложных впечатлений. Внимания достойны только те, кто прошел первичный отбор и способен "грызть гранит". Иначе от "вайтишников" гораздо больше вреда чем пользы. Люди совсем разучатся думать и отвечать за последствия своих действий.
А зачем? Кому он нужен? Приемлемый уровень для одной компании один, для другой — совершенно иной. Рынок отрегулирует. А вот доступность знаний и навыков — это наш долг. Мы же должны передавать опыт, а не отбирать.
Кровью? А зачем все измазывать кровью? Зачем повышать градус стресса на ровном месте. В сущности, только вечные ценности действительно ценны. Все эти знания будут никому не нужны. Мы же идём к повышению уровня абстракции. Вы же видите.
Приемлемый для отношения "сигнал/шум" на рынке разработки. Для любой компании лишний шум создает только дополнительные накладные расходы. Кроме тех, кто зарабатывает на вайтишных курсах, конечно.
Вы правильно сказали про С/Ш на рынке разработки. Но если и дальше пользоваться терминологией в рамках корреляционного приёма, есть четыре гипотезы. В двух из них всё прекрасно. Но есть и две другие — самые сложные. Приняли по ошибке, не приняли, а надо было принять. В первом случае есть возможность быстро выявить ошибку и просто устранить проблему. А вот второй случай — это ошибка компании. Если пользоваться Вашей пороговой функцией, то такие ошибки будут систематическими, к большой радости более проворных конкурентов.
Классическая механика тоже прекрасно существует, но спектр её применения сильно ограничен. Иногда нужна и квантовая, никуда не денешься.
Ошибки второго класса, про которые вы говорите, возможны только для той части спектра, которая уже предварительно ограничена первичным фильтром. В вайтишной зоне они просто статистически ничтожны, исходя из отношения множеств.
Я про гармонические сигналы не говорю, они давно устарели. Только фазоманипулированные сигналы, работать с которыми намного сложнее, но алгоритмы оптимального приёма всё ещё вполне актуальны. Первичные фильтры, к сожалению, здесь не помогут.
Вайтишная зона — это тоже зона приёма, и принимать нужно сигналы и в этой части спектра. Вы же просто её фильтруете. Простой, но устаревший подход. Не для всех сигналов подходит.
Скажу по другому: вайтишный сигнал не только шумный, но и очень слабый. Накладные расходы на его обработку никогда не окупятся. Это все равно что просеивать песок на пляже в поисках золотых крупинок - конечно они там могут попадаться, но они никогда не окупят затрат на оборудование.
А Вам никто не навязывает способы приёма. Вы же сами настраиваете свой приёмник. Пожалуйста. Мы же вообще для всех, кто жаждет знаний и опыта коллег.
Вы должны меня простить, ассоциация-то неправильная у Вас сложилась. Надо об этом говорить, а не о проблемах того, что некоторые компании или отдельные личности хотят денег, обманывая ожидания клиентов.
Интересно, какой будет Ваша реакция, если к Вам придёт кандидат, Вы спросите его о том, где он читает доки, а он скажет, что в Доке. А если на MDN?
А зачем? Кому он нужен?
Инфоцыганам, которые продают курсы «Вайти в айти», к примеру.
А им этот уровень зачем? Они устанавливают тот, который доступен им.
Чтобы выбрать обучающие курсы надо многое пройти. Но ведь это просто услуга сейчас. Разве нет? Ненужные услуги и сами отомрут. Нужные — останутся. Но не бывает иначе.
В выговорите о том, что не нужно делать. А единственный ответ на вопрос «А что же тогда делать?» у Вас один — пробовать и читать доки на английском. Не кажется ли Вам эта позиция устаревшей? Надо ли этим путём, если есть другие? Зачем делать те действия, без которых раньше обойтись было нельзя, но сейчас запросто можно?
А им этот уровень зачем? Они устанавливают тот, который доступен им.
Затем, что, если вне курсов порог будет высоким — им проще будет продавать курсы.
Я страдал, пусть все страдают. Ну такое )
В английском языке есть слово motorist, которое переводится как "водитель" (имеется в виду - своего собственного автомобиля; driver и chaffeur - по работе). Почему такое слово? А оно, оказывается, родом из конца XIX-начала XX века, когда владение личным автомобилем требовало изрядных навыков в его обслуживании и ремонте. Со временем это ушло в прошлое, а слово осталось.
Это я к чему. Вам не нравится, что новички посягают на ваше любимое. Что внезапно оказалось, что разработка - это не техномагия для избранных, а нечто доступное всем желающим. Что можно быть не красноглазым хакером - в опять-таки первичном значении этого слова - а обычным пользователем, которому захотелось что-то освоить. Не больше чем курсы кройки и шитья. Вас это задело (как же так, я всю жизнь учился, у меня образование, а тут какие-то нубы... да как они смеют!) и вы пытаетесь сделать хоть что-то, чтобы помешать этому. Увы, не выйдет, прогресс не остановить.
Прогресс, между прочим, подразумевает повышение комфорта человека. Не ему нужно подстраиваться под условия окружающего мира, а, наоборот, окружающий мир при помощи технических средств подстраивается под него. Прекрасно, что теперь можно изучать документацию на том языке, на котором тебе удобно, а не на том, который волею незнакомых тебе людей назван основным и якобы стандартным.
И да. Русский язык - второй по распространённости язык в интернете. Русскоязычный сегмент интернета - самый развитый после англоязычного по числу собственных, а не глобальных, сервисов разного рода. В странах, в которых распространён русский язык, несмотря на упадок в остальных сферах развитие IT и цифровых технологий (включая сотовую связь, интернет-банкинг и прочее) находится на уровне не только не худшем, но и лучшем, чем в большинстве стран, где распространён английский язык. И, наконец, русский язык внесён ООН в число шести мировых языков. Так что не вижу ничего странного в том, чтобы документация была на русском языке, и тем более не вижу нужды искусственно городить языковой барьер для носителей столь распространённого в IT языка.
Китай молча рыдает в углу
Аргументация ложная, потому что спутаны использование и ковыряние под капотом, простой юзер и профессионал. Что с автомобилем, что с компьютером порог входа для пользователя очевидно уменьшался, а вот для разработчика - скорее даже повысился, если смотреть в комплексе.
“Разработка - нечто доступное всем желающим». Если вы про хтмл/джаваскрипт - ну может быть. И то, даже там хорошо видно, что такое «ща я буду погромистом»: 100500 лишних зависимостей в проекте и неоптимизированные сайты, которые грузятся по 5 секунд и больше.
а уж если говорить про «разработку» как про энтерпрайз или что-то такое - ну вы серьезно тогда про Доку? Вы серьезно про «доступно желающим»? По вашей аналогии, скульптура - это тоже «доступно всем желающим». Только есть скульпторы (которые этому учились и имеют тонну практики), а есть «скульпторы», которые петухов из говна лепят.
А так - да. Ага. Доступно всем желающим.
П.С. Если че - не программист, аналитик данных. От моего кода у вменяемых людей слёзы бегут. ((
Поддержу комментатора выше. Документацию лучше читать сразу на английском, даже если ты находишься на уровне london is the capital of great britain. Таким образом сформируешь привычку учиться на английском и научишься совмещать приятное с полезным.
Да, язык нужно знать, чтобы читать первоисточники. Но если наше сообщество не может делиться опытом в рамках англоязычных справочников — мы запустили русскоязычный и опенсорсный. Попробуйте )
Ну такой себе выход. Вот у меня всё время спрашивают о том, какую книжку почитать. И это большой конфуз, поскольку они почти все уже устарели на старте. А тут актуальная инфа, минимальное время на понимание. Может уже не будем тратить время разработчика на преодоление каких-либо порогов? Может сразу дадим то, чего разработчик желает?
Английский разработчику, конечно, нужен. Но документация на родном языке нужна тоже, хотя бы потому, что ее быстрее читаешь и мозги при этом заняты исключительно самим текстом.
У меня, к примеру, учится советский человек верстать и, в целом, работать со связкой HTML+CSS+SVG. Не программист вообще, и не будет, разве что на уровне написания самых простых скриптов, но не факт. Английский не знает и учить нет смысла: общаться с англоязычными не будет, кроме как ради чтения документации и надписей в нелокализованных программах язык совсем не нужен, а затраты на обучения многократно превосходят затраты на гуглоперевод или чтоб дёрнуть меня. Так вот, хорошая русскоязычная документация высоко ценится, потому что доступна.
Получается какая-то языковая дискриминация. Я, конечно, понимаю, что можно закрыть на меньшинство, которое особо не влияет на экономику, но всё равно обидно получает.
А пишет он как все теги, атрибуты и операторы? Просто заучил наизусть?
В начале перед глазами табличка тег/атрибут/значение — описание на русском языке.
Сейчас частоиспользуемые теги пишутся по памяти. Здесь работает принцип китайской комнаты: не обязательно знать, что в каком-то иностранном языке значит слово «border» или «solid», чтобы понимать, что этот атрибут и это значение позволяют нарисовать обычную рамку вокруг объекта.
Очень люблю доки на русском за то что там сразу выделяется код/операторы, которые на английском и в идеале термины которые не требуют перевода.
Так же и в коде для русскоязычных проектов, на уровня языка разделяются контент и управляющие конструкции / комментарии.
В использовании пары языков много плюсов
Если ты знаешь несколько языков, зачем ограничиваться одним
Почему поддерживать опенсорсный и всемирно известный справочник MDN, переводя имеющиеся там статьи, хуже, чем создавать что-то своё?
Неужели статьи на MDN настолько "скучные", что пришлось писать новые "не скучные"?
Мы поговорили в последних «Веб-стандартах» про Доку и там целая глава в конце: Почему не MDN. Если коротко: там нет авторов, туда нужно сразу писать на английском (это могут немногие), туда сложнее контрибьютить и дружелюбный, простой тон письма, который мы ценим в Доке, там поддерживать сложнее.
Если есть Google, то зачем Bing? Если есть Bing, то зачем Yahoo? Если есть Yahoo, то зачем Яндекс? Если есть Яндекс, то зачем DuckDuckGo?...
Видимо, это ещё один способ. Проведите A/B тестирование. Дайте независимо новичкам MDN и Доку. Посмотрим, что будет удобнее. Скорее в всего, кому то придётся по душе одно, кому-то — другое.
Наличие Bing никак не влияет на Google. По крайней мере, напрямую.
А вот силы, потраченные на наполнение отдельного сервиса, могли бы существенно улучшить уже существующий.
Ошибаетесь, кстати. Напрямую влияет. Влияет на количество рекламы, которая могла бы быть заказана у Google, на оплачивается в Bing. В штатах очень даже популярный сервис, знаете ли. Google не дополучает довольно много денег, благодаря наличию конкурентов. Вы не готовы менять Google на что-то ещё, Вам и не нужен Bing. Но другим нужен.
Но это совсем не важно. Порог, который предлагают авторы MDN, сложно преодолеть большинству. Авторы MDN это почувствовали, кстати. Стараются улучшить их модель. Но нам-то это зачем? Зачем тащить легаси код, когда есть возможность писать сразу в рамках хорошего фреймворка?
Выбор подхода всегда обусловлен деньгами и временем для принятия и реализации решения компании. Нам понадобилось почти три года и множество упущенной личной выгоды, чтобы сделать новый фреймворк для документации. Мы смогли, нашли приемлемый вариант реализации и сделали дело. И сможем двигаться дальше. Уже не надо выбирать подход. Проблема такая уже не стоит, А Вы всё о ней говорите. То есть Вы говорите нам трёхлетней давности. Плюс к этому русскоязычное сообщество тоже надо развивать. А то останутся только недовольные окружающим миром снобы.
Вам жалко потраченных усилий? Наших усилий? Не жалейте нас и приходите в ишью и пары. Мы Вас ждём с большим удовольствием. Совсем не так, как ждёт Вас MDN.
Почему название именно дока?
Не кажется, что слишком абстрактное название?
Так много пустого места и так мало полезной информации на экране. Этому сейчас web-разработчиков учат?
Пять слов (Поиск HTML CSS Javascript Инструменты) . Четверть площади экрана.
Это вопрос скорее к дизайнерам, которые помогали создавать проект. Разработчиков учат скорее переносить дизайн в код.
Правда классно, что хоть кто-то делает человеческие интерфейсы, а не дашборд?
А чем блок 530x640 пикселей с 10 словами человечнее компактного интерфейса, где соблюден баланс между количеством информации на квадратный сантиметр экрана и свободным местом?
Скриншот
Также на сайте размер шрифта для текста под 29 пикселей, но при этом ощущение каши не покидает, когда видишь такую простыню
Скриншот
Рекомендую открыть отдельно в новой вкладке, а то при чтении из комментариев можно подумать, что вполне себе нормальный размер шрифта
Крайний случай? Спасибо, но мы уже работаем и над этим.
А у нас ишью есть. Приходите. Мы открыты для улучшений и изменений. Мы готовы быть максимально полезными и удобными.
Вообще я люблю крупный читаемый текст, большинство сайтов использую в режиме 120-150%, коллеги бывает, видя мой монитор, говорят «ой как у тебя крупно» — так вот даже для меня ваш сайт слишком крупный, как детская книжка-картонка для взрослого. Такое ощущение, что 27-дюймовый монитор схлопнулся до ноута.
Ну как-бы разработчик должен уметь хотя-бы читать документацию и ещё желательно - понимать.
Документация на должна быть доброй, она должна быть понятной. А вообще уже хорошо, если она вообще есть. Тот-же MDN будет на порядок полезнее. И разработчик должен уметь искать и использовать любые крупицы информации.
Мы уже получили уйму "разработчиков" с Практикума, которые без stackoverflow даже hello word не способны сделать. Я так понимаю - это следующий виток?
Вообще, больше похоже на пр-проект, неужели что-то полезное для нормальных разработчиков, уж извините.
Куча пустого неорганизованного места, и евангелист Оперы, который не смог и подался в евангелисты веба и теперь главный редактор - это прям вишенка.
Как бы зло не звучало, но пр курсов и популяризация "легкого" веба для масс достала.
Лично моё ИМХО, никому не навязываю.
Концепт хороший. То что проект не забросят, я тоже уверен, но пожалуйста поправьте выбор цветов для темной темы. Я сам большой сторонник темных тем и она у меня стоит как предпочитаемая, да и вы не далекие от дизайна люди, как тогда вышло, что у вас абсолютно черный фон с абсолютно белым текстом.
Доки это место где разработчик достаточно долго работает с текстом и сочетание чисто черного с белым очень быстро утомит читателей.
Мы сейчас как раз обсуждаем изменения в темную тему. Приходи в ишью и вместе сделаем лучше ?
У нас есть дискуссия об этом в ишью, присоединяйтесь )
Автор, а другие разделы будут?.... по языкам там...
Планируем другие разделы! По языкам или нет, скоро увидите :)
Мы хотим максимально и полезно покрыть то, что есть сейчас.
Но проект принадлежит сообществу, если однажды сообщество решит, что вот прям надо-надо, и будет готово написать много полезного на эту тему, то почему бы и нет? Можно будет потом и посмотреть.
А мне - понравилось. Что то подзабыл - глянул. Особенно полезно новичкам. Спасибо!
По js, конечно, будет непросто превзойти знаменитый учебник learn.javascript.ru - там уж очень годно всё разобрано.
Благодарю, очень удобно как в шпаргалку поглядывать иногда. Надеюсь, не забросите и проект будет развиваться и дополняться.
Спасибо, мне понравилось. Добавил в закладки. Надеюсь до PHP тоже дойдете. Всяческих успехов вам!
Обычно я жалуюсь на сайты, что "мелко". Тут случай наоборот - прямо слишком крупно. У меня монитор 35 дюймов и что же? В это огромное пространство с огромнейшим трудом влезает один небольшой абзац текста. Часто к тому же ещё и неполный.
А эти адские отступы по краям. Не знаю, может с экрана какого-то макбука или смартфона это и выглядит красиво и компактно, но...
Или, захотел я найти например что-то по тэгу tr, но нет, нельзя. Чтобы найти что-то по tr надо искать или td или table. И. Интуитивно.
И снова, адские размерища всего этого на экране. На главной странице на один экран не влезают даже первые три заголовка статьи.
Заголовки с картинками. Это вроде как бы модно стильно молодёжно, но в самих статьях ты перестаёшь понимать куды ты попал и что происходит вообще. Ну то есть, ну ёпт..
Веб-дизайнеры за дизайном напрочь забывают про юзабилити. А иногда и про смысл происходящего. Как связан тэг <input> с чуваком жрущим сосиску и жирной надписью "сосиска", которая воспринимается как заголовок?
Вот эта разбивка на маленькие клочки информации более вредит чем помогает. Три страницы только по формам. Все страницы в примерах используют инпут. Перекрёстные ссылки? Не, не слышали.
Если это ориентация "для специалистов", то хочется прийти и получить информацию, а не прийти, войти в поиск, с удивлением открыть штук пять вкладок и с интересом выкусывать инфу то тут то там. Нет, это красиво, больше страниц, индекскация, не знаю, но всё в ущерб юзабилити, опять же.
Какие-то очень противоречивые чувства. Особенно на фоне десятков альтернативных сайтов с аналогичной +/- одинаковой обновляемой документацией.
Обычно я жалуюсь на сайты, что "мелко". Тут случай наоборот — прямо слишком крупно.
В вашем браузере не работает Ctrl+колёсико?
Не вижу ни одной причины, чтобы не прийти в ишью. Помогите нам по-настоящему, профессионально, как Вы можете. Наверняка Вы принесёте много пользы :)
Насчёт интерфейсов — ну сложно это, сделать что-то действительно крутое и интересное. Это путь. Мы в начале этого пути. Аж зудит что-то исправить и улучшить. Нам важны мнения. А если эти мнения выражены в форме ишью — цены им нет!
Очень хорошо, что есть раздел инструменты! Особенно разделы по GIT и Docker. Цветовое решение и дизайн можно будет еще доработать, но главное - информация представлено наглядно.
конечно плюс за https://doka.guide/js/async-in-js/ и другое полезное, но есть технические замечания - невозможно пользоваться с телефона - нет responsive подправьте свой собираемый из многих импортов css в разделе media query. И ещё один вопрос, а почему не readthedoc? Это тоже почти такой же Статик джемстэк как 11ty+netlify, но изкаропки сделан для документации. Могли бы захостить и в гитхабпейжес.
Мы выбрали 11ty+netlify, чтобы быстро запустить MVP, да и опыт был именно с ним. Про технические замечания можно завести issue в платформе, так их будет проще отслеживать и всё починить.
Мы рассматривали разные варианты, в том числе специально заточенные под документацию, типа GitBook, но все они либо не давали лёгкой возможности кастомизации, либо тащили свои процессы публикации. В общем, дьявол в деталях, которые не поменяешь.
В итоге мы решили развязать себе руки и выбрать самое гибкое решение.
Большая часть команды разработки этого ресурса - из Нетология, во главе с Батицкой) Почему так?)
Хороший ресурс для ИТ-пиарщиков, чтобы проще вникать в матчасть, спасибо, Вадим и команда!
Пару часов назад только смотрел видос на канале Вадима, как сейчас уже в гугл discover увидел эту статью, прекол
Вадим крутой кста)
А я просто скажу 'Спасибо' за хорошую и главное актуальную информацию.
Ибо читая (как новичок) информацию на том же МДН, иногда теряю суть статьи за моментами перевода.
Извиняюсь, но у меня одного весит это огромное меню, которое занимает ровно половину экрана и его невозможно закрыть? Что на компе, что на мобилке. Как-то не очень для сайта про веб стандарты
Наткнулся на сей прекрасный сайт, потом обнаружил эту статью. Ба.. какие люди, какие компании!
Запустилась Дока — опенсорсный справочник по веб-разработке