Про документацию
Уже которую неделю вижу в комментариях сообщения, мол «это нужно добавить в документацию», «а почему этого нет в документации» и подобные.
В связи с чем хочу напомнить, что у нас давно есть открытая документация, куда любой желающий может добавить что угодно! И сделали её такой именно для того, чтобы пополнять её могли все, а не только избранные.
Сколько можно ныть в комментариях?
Считаешь, что нужно что-то добавить — добавь. Считаешь, что такая статья должна быть — напиши и пришли. Кто мешает?
Или это как с чистотой улиц за окном, кто-то другой должен сделать хорошо, а я буду только требовать порядка, сам раскидывая окурки? Есть же дворники, это их работа, я им за это налоги плачу — такая логика?
Так вот, друзья, у нас тут дворников нет, и писать документацию некому, кроме вас.
В этом сообществе зарегистрировано несколько тысяч человек, при этом авторов документации всего 48. Хотите хорошие тексты — пишите их сами, инструмент для этого давно разработан и прекрасно работает.
За сим, впредь предлагаю всё нытьё о документации в комментариях минусовать.
В связи с чем хочу напомнить, что у нас давно есть открытая документация, куда любой желающий может добавить что угодно! И сделали её такой именно для того, чтобы пополнять её могли все, а не только избранные.
Сколько можно ныть в комментариях?
Считаешь, что нужно что-то добавить — добавь. Считаешь, что такая статья должна быть — напиши и пришли. Кто мешает?
Или это как с чистотой улиц за окном, кто-то другой должен сделать хорошо, а я буду только требовать порядка, сам раскидывая окурки? Есть же дворники, это их работа, я им за это налоги плачу — такая логика?
Так вот, друзья, у нас тут дворников нет, и писать документацию некому, кроме вас.
В этом сообществе зарегистрировано несколько тысяч человек, при этом авторов документации всего 48. Хотите хорошие тексты — пишите их сами, инструмент для этого давно разработан и прекрасно работает.
За сим, впредь предлагаю всё нытьё о документации в комментариях минусовать.
Комментарии: 26
Авторизуйтесь или зарегистрируйтесь, чтобы оставлять комментарии.
Просто мне не все равно, а когда тебе не все равно, ты высказываешься, аналогично Василию. Ведь так?
Это как документация, важная экологическая тема для данного сообщества. Хотя ассоциативный ряд представленный в посте мне не ясен, я читал много раз доку и не видел там свинарника, изначально пишет человек, который в этом хорошо разбирается и он пишет в мысленном инкубаторе, опуская маловажные моменты — это нормально.
Вангую появление платных видео курсов в модсторе на тему «как создать магазин» и т.д.
— ЗЫ: Да, ошибку допустил, мог проглядеть с телефона писал :)
Возможно некая общая негативная тенденция сообщества, лично я ничего не имею против платного расширения/дополнения, тем более оно идет с поддержкой и обновлениями, да и если готовое решение поможет сделать задачу быстрее и качественнее, то дополнительные средства на неё выделить можно — это же не десятки и сотни тысяч. Малый бизнес, он такой :)
Люди разные и мнение разное, такое бывает.
Спасибо, я что хотел — ответ получил.
В остальном хороший flat.
По видео контенту — сами уроки, лично мне нравится формат лофтскул т.е. довольно сжатые уроки, хорошо продуманные и без лишней воды. Советую ;)
Про лофтблог знаю, еще есть ларакаст и друпализми (ценник адовый у них) и другие проекты, которые делают именно короткие ролики по существу. Уроков хватает в сети, но смотреть, как некий условный Петя полтора часа дрочит блог на MODX, у меня вызывает отвращение :)
Еще интересные варианты есть в игровой форме от codeschool (встречал и русский аналог) т.е. они дают ролик, далее задание и ты должен выполнить его в рамках ресурса и так поэтапно. В таком варианте, не получится сказать себе, что «я посмотрел я все понял, давай дальше» обойдя тем самым практику.
В целом концепция codeschool интереснее чем loftschool. Ведь если вспомнить с чего начинали ребята из лофтскула, то это были ролики на канале ютуба и «стримы» после основного рабочего дня, теперь же они смогли найти достаточное кол-во единомышленников и систематизировать свой бизнес процесс. Теперь работа на идею — это не их, только монетизация, рано или поздно все к этому приходят, но монетизация есть разная, агрессивная или мягкая с приманками :)
Проявив интерес к начальному блоку курса, допустим некая база, можно ознакомить человека с общей концепцией и собственно дать привыкнуть к преподавателю (голос, манеры и т.д.). Добавив кучку роликов с кейсами (периодически), можно подогреть интерес к продуктам (допустим из модстора — особенно есть есть рефер ссылки), ну и основываясь на самых просматриваемых кейсах, делать курсы по работе с тем или иным дополнением раскрывая весь потенциал и гибкость.
Понятное дело есть платные курсы с преподавателем, там не то что вода, там океанище :) и рано или поздно все платное, становится достоянием торрента по этому в этой сфере идет постоянный апдейт курсов.
Ну это чисто такое мое понимание/мнение.
Приходится соблюдать некоторые формальности, связанные с законом.
П.С. Мне сайт понравился. Осталось набить материалом.
P.S.: Это считается признаком хорошего тона, когда ты исправляешь даже элементарную опечатку, даже запятую, поставленную не в том месте. А от прочтения документации улучшается понимание работы компонентов.
P.P.S.: Нам, разработчикам, будет легче в последующем разрабатывать функционал читая подробную документацию.
нытьё…
предлагаю минусовать…
Неужели необходимо писать именно так? Можно изложить мягче, и раздражённых пользователей будет гораздо меньше.
Я не оспариваю эту заметку, но от прочитанного становится противно.
Пару предложений? или нужно целую страницу писать?
2) Посмотреть историю изменений можно на github
Есть Ubuntu 16.04, а есть 16.10 и пользователь, выбирая версию 16.04 уверен, что в течение последующих нескольких лет не останется без поддержки. Может быть не очень корректное сравнение, т.к. здесь речь идёт не о поддержке, а о том, что выбирая какое-либо приложение и устанавливая его на сайт, пользователь должен знать, что он сможет обратиться к документации в течение нескольких лет.