Хорошо, что вы, fori1ton, об этом спросили. Мне самому интересно, как коллеги оценивают мою работу и нужна ли она вообще кому-то. Вот и выясним.
Уважаемые коллеги, тут довольно много текста, но я расставил осмысленные заголовки, так что вы можете пролистать и прочитать только те разделы, которые вам интересны.
Зачем и почему я всё это делаю
Почему
Некоторое время назад обсуждался вопрос Стоит ли переводить вопросы и ответы с англоязычного SO?. Ответ был положительный, сообщество одобрило эту идею.
Я пока что компетентен в небольшом круге тем: Java и Git. К тому же неплохо знаю английский и имею некоторые навыки технического писательства. Поэтому задача показалась мне интересной. По Java и так много энтузиастов (которые еще и гораздо опытнее меня), а вот Git на мой взгляд обычно всем скучен. По крайней мере, те популярные вопросы, которые уже были на RU.SO, касались концептуальных вопросов: в чем различия, как организовать рабочий процесс. А вот детальных руководств (которых на EN.SO есть около полусотни популярных) не было.
Зачем
Всё это приводит к тому, что я могу внести существенный вклад в развитие StackOverflow на русском языке, переводя лучшие вопросы с EN.SO и других ресурсов. И первая тема, которой я могу заняться - Git.
Как
Задал вопрос Какие вопросы про Git целесообразно перевести с английского? Начал понемногу работать. На деле оказывается, что я ни разу не перевел вопрос и ответ дословно. Там всегда есть несколько вариантов, в них где-то есть ошибки, какая-то информация относится к устаревшей версии. В процессе написания ответа я прорабатываю от трех до десяти аналогичных вопросов на английском, включая все ответы и все комментарии, плюс один-два источника документации.
Обычно на один ответ уходит часа три-четыре работы. Но последний, как раз тот, что я добавил в описание метки, занял уже больше 10 часов. Оказалось, что есть много тонкостей, о которых я даже не подозревал на момент публикации первой версии. Несколько пользователей указали мне на мои ошибки или задали уточняющие вопросы. Вопрос выдержал два десятка правок.
Вот что я сделал на сегодняшний день:
Как показать N последних тегов (меток)?
Как добавлять файлы в Git по их номеру в отчете `git status`?
Как вернуться (откатиться) к более раннему коммиту?
В чем разница между git add ., add -A, add -u и add *?
Настройка и развертывание проекта c помощью Git
Почему и как я пишу описания меток
В процессе работы над вопросами я пришел к выводу, что к хорошим вопросам необходимы еще и релевантные метки. Поэтому создал вопрос Как правильно составлять описание метки (tag wiki)? Что туда включать?. Большой популярностью он не пользовался, но сам для себя я разработал шаблон хорошего содержания метки. Этот шаблон в том числе включал две категории:
- Часто задаваемые вопросы. Те проблемы, с которыми обычно сталкиваются рано или поздно все. Цель - повысить полезность от хороших ответов и понизить количество дублей.
- Рекомендуемые вопросы. То, что по субъективному мнению авторов описания метки имеет важное значение для концептуального понимания темы. Цель - дать человеку более полное понимание темы и тем самым понизить количество будущих ошибок. Например, про git важно понимать, как устроен коммит, и является он патчем/дельтой или снимком (snapshot).
По этим шаблонам я уже сделал описания знаков git-commit, git-add, git-flow, git-branch и планирую сделать их еще для полутора десятков.
Зачем вообще нужны детальные/конкретные метки,
созданные и продвигаемые пользователем @Nick Volynkin как здесь, так и на большом SO
Зачем нужны сами конкретные метки
Почитайте, например, вот это обсуждение на мете: Can we get rid of [git-something] tags. Там выделяются 4 основных причины (перевожу, выделение авторское, комментарии переводчика курсивом):
<перевод>
- Для экспертов по меткам. Как подчеркивает Cupcake, конкретные метки позволяют быстрее находить дубликаты вопросов.
Да, дельных ответов про Git у нас пока мало, можно и наизусть запомнить. Но сообщество растет, база знаний ширится и если сразу не задать четкую структуру, то будет накапливаться бардак и хаос. Мы ведь хотим меньше дублей?
- Для обычных пользователей: Конкретные метки позволяют проще находить подходящие вопросы, когда пользователь хочет найти больше информации по каждой конкретной команде.
Я лично этим часто пользуюсь на EN.SO. Начинаю с чтения tag wiki и далее по популярным вопросам.
- Для спрашивающих: Если конкретные метки убрать, то большинству спрашивающих останется только одна метка [git]. Не имея возможности использовать соответствующие осмысленные метки, пользователи наверняка начнут использовать некорректные обобщенные метки вроде [команда] и [репозиторий]. Удаление конкретных меток приведет к использованию других, ошибочных.
Моя любимая метка - [ошибка]
Для отвечающих: Как подчеркнул megawac, отвечающие могут отслеживать специфические метки, потому что именно по ним бывают интересные им вопросы про Git. Зонтичная метка [git] слишком широка.
megawac: Я отслеживаю git-tree-filter
и некоторые другие узкие темы...
Совершенно верно. Вопросы с только меткой [git] обычно заключаются в том, что человек не читал документацию. Они вызывают злость. Вопросы с [git-fsck] или [git-filter-branch] обычно требуют хороших знаний Git, shell, и чего-нибудь еще. Они реально интересные.
Описания конкретных меток будут потеряны, если метки удалить или слить.
Или никогда не будут созданы.
</перевод>
- Еще для экспертов - возможность заработать дополнительные знаки. Например, очень уважаемый мной эксперт VonC имеет только по git-меткам знаки за git, atlassian-sourcetree, git-diff, git-pull, git-tag, git-fork, git-bash, github-api, commit, gitignore, git-flow, githooks, rebase, bitbucket, git-submodules, egit, git-merge, git-commit...
Чем ценны описания конкретных меток
Тем, что они представляют собой краткую документацию по предмету конкретной метки. В случае с Git это команда, концепция (как git flow) или связанный инструмент (как GitHub). Если конкретной метки не будет, то в описание общей метки всё впихнуть не получится. Придется оставить только ссылки, а "просто ссылка" на SO не приветствуется.
Как неоднократно повторялось, миссия Stack Overflow — организация знаний. На мой взгляд, описания меток - тоже способ организации знаний и я его использую.
Про пользователя @NickVolynkin
Вопросы по конкретным меткам
нужны ли вообще метки ..., созданные и продвигаемые пользователем @Nick Volynkin ... здесь
Я уже объяснил, почему они нужны и важны, и особенно здесь и на этом этапе развития сообщества.
нужны ли вообще метки ..., созданные и продвигаемые пользователем @Nick Volynkin ... и на большом SO**
Вы можете аргументировать свои слова или просто пальцем в небо? На данный момент, я на EN.SO создал одну метку из примерно полусотни. Вся основная структура создана до меня.
как на ru.SO, ... вопросы по ним задавал только пользователь @Nick Volynkin.
Опять вы голословны.
До моего вмешательства существовали метки github, gitlab, git-commit, git-svn, tortoise-git (и ошибочный turtoise) и несколько других. По ним задавали вопросы.
будут ли новые вопросы задаваться с этими метками?
Вот новый вопрос с недавно созданной мной меткой [git-branch]: Работа одноврменно с двумя ветками. Метку сразу использовал ОП. Вывод: конкретные метки используют разные люди, не только я.
Да, я просмотрел большинство старых вопросов и отредактировал часть из них их, добавив соответствующие конкретные метки. Цель была в том, чтобы по каждой метке реально можно было найти выборку лучших ответов по соответствующей теме. По многим меткам уже можно.
так и на SO вопросы по ним задавал только пользователь @Nick Volynkin.
Простите мне мой французский, но это несусветная чушь. Посмотрите хотя бы на этот вопрос, найдите там меня хоть где-нибудь на странице: Edit an incorrect commit message in Git. Теперь посмотрите на топ любой метки по Git. Даже в первых сотнях там нет моих вопросов и ответов.
Про правку
Вообще, предыдущая редакция описания метки тоже была сделана мной с нуля. И метка была создана за пару дней до этого тоже мной.
кроме этих изменений правка ничего не содержала.
Неверно. В правку были добавлены два новых вопроса. Один из них я только что написал, да. Можете считать что я его пиарю. Но это качественный вопрос-руководство и я отвечаю за его качество и достоверность. В этом описании есть и ответы других авторов. Как я их нашел? Просто прочитал с полсотни самых популярных вопросов и ответов и выбрал лучшее.
Да, все вопросы выбраны только мной на основе только моего субъективного мнения. Почему так? Потому что на данный момент только я пожелал внести вклад в создание метки. У нас тут на SO технократия. Имеете свое аргументированное мнение - добро пожаловать в редакторы, там еще много меток без описания.
Про знаки Диктор, Усилитель и Публицист.
В указанной Вами правке я действительно заменил более ранние ссылки на другой формат, который мне кажется более лаконичным. И эти ссылки удобнее забирать с конкретных постов, так как они получаются по нажатию кнопки L на посте. (Осваиваю управление SO с клавиатуры).
Я только сейчас задался вопросом, как вообще работает эта реферальная система и как считаются переходы. Суть в том, что в такой ссылке есть мой user id. Поможет ли мне это зарабатывать какие-то знаки? Ссылки-то внутри RU.SO расположены. Я задал вопрос об этом на мете и получил ответ модератора: Does announcer badge count increase when link is opened from inside StackExchange network?
Ответ модератора: НЕТ, ссылки внутри SE не увеличивают счетчик реферальных ссылок
Без особого напряга
возможность без особого напряга заработать знаки
Про знаки уже всё понятно. Давайте-ка сравним возможности зарабатывания чего-нибудь еще за счет вопросов на RU.SO.
Вот я недавно ответил на дурацкий вопрос на EN.SO. Заработал 45 репутации за 15 минут - это 180 репы в час.
Вспомним мой последний вопрос-ответ про git add
. 10 часов, на данный момент 150 репутации в сумме. Это 15 репы в час.
Напомню, это вообще нормальные рабочие часы квалифицированного труда программиста-джуниора. Я не думаю, что об этом можно сказать "без особого напряга". Тем более, это не зарплата какая-нибудь, а пиксели. Максимум материальной пользы, который я могу извлечь - это ускорить решение собственного ответа за счет назначения награды, на которую потрачу заработанную репутацию. Ну еще при трудоустройстве могу похвастаться.
Для меня смысл моей работы здесь - внести свой вклад в базу знаний теми навыками, которые у меня есть. Знаки и репутация вторичны, хотя они, конечно, делают процесс интереснее.