Содержание
Как посмотреть свои комментарии в Яндекс Дзен и удалить их на канале
Если вам интересно, как посмотреть свои комментарии в Яндекс Дзен, а также все, что связано с этой опцией – то внимательно изучите нашу статью с подробными инструкциями. Начнем по порядку!
Возможность оставлять комменты на веб-сервисе доступна всем авторизованным пользователям, даже тем, кто не является подписчиком канала. А вот посмотреть в одном месте все оставленные вами когда-либо комментарии, если вы читатель, не получится. Такой раздел доступен только для авторов в «Редакторе«. Обычным пользователям не остается ничего другого, кроме как попытаться вспомнить, в каких статьях они оставляли отзывы или общались с другими читателями.
Как посмотреть?
Авторы имеют право комментировать свои же статьи, а также просматривать ответы и отвечать на предыдущие записи. Эта инструкция точно пригодится тем авторам каналов Яндекс Дзен, которые хотят оперативно просматривать новые записи к своим статьям:
- Зайдите в Редактор;
- Справа вверху, рядом с логотипом автора находится значок с изображением колокольчика;
- Щелкните по нему, чтобы раскрылось окно с уведомлениями;
- Если кликните по шестеренке, сумеете настроить блок, чтобы здесь отображались оповещения только о новых комментариях;
- Когда вы получите новый ответ к своему тексту, над колокольчиком загорится красная точка. Чтобы его посмотреть, щелкните по оповещению.
Как удалить?
Теперь мы покажем, как удалить комментарий в Яндекс Дзен, а также как восстановить удаленную запись, если вы отправили ее в корзину по ошибке.
- Найдите запись, которую требуется удалить и щелкните по трем горизонтальным точкам под ней;
- Выберите клавишу с корзинкой и щелкните;
- До тех пор, пока вы не обновили страницу, у вас есть возможность вернуть ответ на место.
Автор канала может посмотреть и удалить любой комментарий к своим публикациям, а вот читатель сумеет убрать только свои собственные.
- Оставьте свой комментарий в Дзен и попробуйте его стереть, щелкнув по трем точкам.
- А теперь нажмите на этот же значок, но к чужому ответу – корзинки вы там не увидите.
Четких правил написания комментариев на каналах Яндекс Дзен не существует, но за спам, нецензурную брань, ложные обвинения, рекламу и прочие действия, попадающие под нарушение требований к общему контенту веб-сервиса, на пользователя можно подать жалобу или заблокировать ему доступ. О том, как это сделать, мы расскажем в конце.
Как отключить комментирование?
Автор волен закрыть или открыть возможность к той или иной публикации. Эта опция никак не влияет на ранжирование публикации в персональных подборках читателей, но она важна для показателя Вовлеченности в Карме.
Яндекс Дзен приветствует обратную связь с читателями, так как это стимулирует читательскую активность, а значит, интерес к веб-сервису. Поэтому подумайте, прежде чем закрывать возможность комментирования для ваших читателей. Если же вы все-таки не передумали, то держите инструкцию:
- После того, как вы подготовите статью в Редакторе, нажмите клавишу «Опубликовать»;
- В окне финального редактирования найдите раздел «Настройки»;
- Поставьте галку в пункте «Отключить комменты».
- Если посмотреть на эту статью после публикации, станет видно, что возможность обратной связи отсутствует.
Обратите внимание, Яндекс Дзен не разрешает оставлять комментарии для публикаций типа «Нарратив», «Видео/Gif», а также для текстов из RSS-лент. В том случае, если вы хотите посмотреть более полную информацию, то зайдите в раздел Помощи по ссылке: https://yandex.ru/support/zen/channel/author-comments.html
Действия с комментариями
- Отвечать можно от имени пользователя, или от имени канала;
- Разрешается менять имя и фотографию в отзывах и комментах через специальный раздел в Яндекс Паспорте: https://passport.yandex.ru/profile/display-name
- Разрешается посмотреть предыдущую запись и ответить на нее;
- Свои комментарии легко отредактировать, но только в пределах 60 минут после размещения;
- Максимальная длина ответа – 4000 знаков с пробелами, нельзя вставлять гиперссылки и картинки;
- Если скопируете ссылку, сумеете поделиться записью с другими пользователями. При переходе, они смогут посмотреть ваш ответ.
- Ответы сортируются по времени или рейтингу, их разрешено оценивать меткой «Лайк»;
Как пожаловаться на ответ?
Спамить в комментариях Яндекс Дзен запрещено, каждый пользователь должен знать, что на записи распространяются общие требования к контенту веб-сервиса. Посмотреть их можно, пройдя по этой ссылке: https://yandex.ru/support/zen/requirements/rules.html
- Чтобы пожаловаться на автора неподобающей записи, нажмите на три точки и выберите соответствующую команду;
- Автор имеет право наложить ограничения на читателя Яндекс Дзен – заблокировать комментарии от этого человека. Действие доступно через то же меню через три точки.
Никто не сумеет посмотреть ваши жалобы или списки заблокированных людей – на Яндекс Дзен эти действия анонимны.
В завершение дадим совет: рекомендуем побуждать читателей к диалогу, формируя в конце текста смысловые вопросы. Активно налаживайте обратную связь, чтобы поладить со своей аудиторией, и тогда результат не заставит себя ждать!
Как в Дзене посмотреть свои лайки
Статьи › Дзен
Как посмотреть свои лайки ВК с телефона? В мобильном приложении ВК
- Вкладка Сервисы (вторая кнопка в нижнем ряду).
- Кнопка меню (≡) справа вверху.
- Закладки.
- Реакции.
- Чтобы уточнить поиск, далее можно выбрать, что показать из понравившегося: Записи, Комментарии, Клипы, Видео, Товары и услуги.
- Как в Дзене посмотреть сохраненные публикации
- Как получить синюю галочку в Дзене
- Как проверить лайки друзей в ВК
- Где мне Нравится в ВК
- Что с лентой в Дзене
- Что означают показы на Дзене
- Как в Яндекс Дзене посмотреть своих подписчиков
- Что значит слово дзен
- Что значит ловить дзен
- Как ставить хэштеги в дзене
- Кто видит мои лайки в ВК
- Как узнать когда человек поставил лайк
- Как узнать сколько лайков я поставил в ВК
- Как найти закладки в ВК
Как в Дзене посмотреть сохраненные публикации
Новый пункт «Сохраненное» уже появился в меню десктопной и мобильной версии сервиса. Теперь можно выбрать любую публикацию, нажать на три точки в правом верхнем углу и, нажав «Сохранить», посмотреть ее в удобное время или показать друзьям при случае. Публикации можно найти в разделе «Сохраненное».
Как получить синюю галочку в Дзене
Теперь медиа, компании и блогеры смогут защитить свой канал узнаваемой синей галочкой. Для того, чтобы получить значок верификации, нужно документально подтвердить подлинность, иметь соответствующее оформление и регулярно делиться контентом.
Как проверить лайки друзей в ВК
Начните по зеленой кнопке внизу, чтобы посмотреть лайки у любого человека ВКонтакте. Укажите ссылку на страничку ВК этого человека, отметьте сбор лайкеров, поставив галки напротив позиций «лайки», а инструмент соберет для вас тех, кто поставил лайки этому человеку ВКонтакте.
Где мне Нравится в ВК
В мобильных клиентах зайдите в раздел новостей, нажмите вверху на надпись «Новости» и в открывшемся списке выберите «Понравилось». В веб-версии с компьютера эта вкладка находится там же — в новостях. Найдите справа список «Понравилось» или, если его там нет, нажмите на иконку с плюсом и включите его.
Что с лентой в Дзене
Команда Дзена приняла сложное решение — с сегодняшнего дня Яндекс Дзен переходит от рекомендательной ленты на формат подписок. Наша аудитория будет видеть только контент тех авторов, на которых подписана. Это решение временное. В текущей ситуации Дзен не может доверять распространение контента алгоритмами.
Что означают показы на Дзене
Показы — это количество неуникальных пользователей, которые видят в своей ленте превью статьи. Охват — количество уникальных пользователей, которым показали превью. Например, открывая ленту Дзена, я вижу карточку статьи. Это охват.
Как в Яндекс Дзене посмотреть своих подписчиков
Если перед вами стоит задача просмотреть подписчиков в Яндекс. Дзен не через компьютер, а в мобильном приложении, тогда будет нужно зайти и авторизоваться в своем канале «Яндекс. Дзен». Далее следуют вход в ваш Профиль, кнопка «Подписки», и вы увидите все страницы, на которые подписаны.
Что значит слово дзен
Дзен это одно из ключевых понятий в буддизме, суть которого заключается в мистическом «созерцании» внутреннего и внешнего миров созерцающего. Созерцании, целью которого является достижение просветления. Японское слово «дзен» восходит к древнеиндийскому «дхьяна», означающему «погружение, глубокое созерцание».
Что значит ловить дзен
Эта концепция предполагает обязательное отсутствие негативных эмоций при анализе, взгляд на произошедшее со стороны и оценка возможных последствий. Кажется, что это упражнение требует значительного времени, но это не так.
Как ставить хэштеги в дзене
Чтобы разместить нужные теги в тексте, необходимо нажать на решетку (цифра «3» в верхнем регистре клавиатуры), задержать клавишу до тех пора, пока не появится ромбик и начать печать тег. Все просто!
Кто видит мои лайки в ВК
Если ваш друг зайдёт в сообщество и посмотрит запись, которую вы лайкнули или прокомментировали, он сможет увидеть ваш лайк и комментарий. Это уже никак не скрыть.
Как узнать когда человек поставил лайк
Кто поставил лайк, реакцию на фото, видео
Нажми на кнопку комментирования внизу. Под фото будет список «Понравилось (таким-то людям)». Нажми на него. Если его не видно после открытия комментариев, прокрути ленту немного назад.
Как узнать сколько лайков я поставил в ВК
Если вам нужно узнать, кто сколько поставил лайков ВКонтакте, то наш Сервис VK.BARKOV.NET предоставит вам такой специальный инструмент (парсер). Запустите ссылку, расположенную ниже. Загрузив ссылки на группы ВКонтакте в поле поиска, отметьте ТОП-овое количество искомых активных пользователей ВК.
Как найти закладки в ВК
Как открыть и посмотреть закладки
Раздел, где сохраняются посты так и называется «Закладки». Он находится в левом меню, прямо под основным. Зайдя в раздел можно отсортировать все сохранённые материалы по категориям.
Zen Habits Часто задаваемые вопросы (FAQ)
Сообщение написано Лео Бабаута.
Мне задают много вопросов, многие из них неоднократно, и я решил, что вместо того, чтобы отвечать на них снова и снова, я соберу свои ответы для всех здесь.
Конечно, на странице «О нас» можно найти гораздо больше обо мне и этом сайте, и мне всегда будет приятно, если вы заглянете на страницу «Книги».
Надеюсь, вы найдете это полезным!
1. Почему вы отключили комментарии к Zen Habits?
Это было самое сложное решение, которое я принял с момента запуска Zen Habits, так как мне очень нравились комментарии здесь. Мне нравится слушать читателей, и я считаю, что комментарии часто содержат более полезные советы, чем сами сообщения. Я многому научился (и до сих пор учусь) у своих читателей.
Так почему же я отключил комментарии? Было слишком много спама в комментариях, что привело к огромной головной боли для меня. Серьезно, это отняло у меня много времени — времени, которое я хотел потратить на творчество или на свою семью. И крошечное меньшинство законных комментариев было в основном блогерами, пытающимися быть замеченными — не то чтобы в этом что-то не так, но я просто не хочу тратить свою жизнь на модерацию спама только по этой причине.
Да, я пробовал несколько различных программ для борьбы со спамом в комментариях, и они не решают проблему людей, оставляющих спам в комментариях. Даже такие вещи, как Askimet (и многие другие подобные фильтры) и CAPTCHA пропускают много спама. Поверьте мне, я провел много исследований, и когда спамеры мотивированы, они найдут путь для сайта с таким трафиком.
Люди по-прежнему могут оставлять мне отзывы через Твиттер, и если я не всегда отвечаю, я слушаю. Избавляться от комментариев было прискорбно, но они не масштабируются, и это принесло покой в мою жизнь.
2. Когда и почему вы переезжаете в Сан-Франциско?
Мы переезжаем в Сан-Франциско этим летом — в конце июня 2010 года. (Обновление : мы уже переехали в Сан-Франциско)
И мы очень взволнованы.
Мы купили билеты на самолет, но еще не забронировали дом или квартиру. Мы будем жить в городе, без машины.
Мы продаем все наши вещи, кроме нескольких вещей, моего ноутбука и нескольких произведений искусства.
Я знаю, что животрепещущий вопрос — почему. Причины многообразны, но вот некоторые из них:
- Гуам всегда будет домом, но мы хотели бы узнать больше о мире, и мы хотели бы, чтобы наши дети увидели больше, чем этот крошечный кусочек жизни, каким бы прекрасным он ни был.
- Сан-Франциско — одно из моих любимых мест в мире — я жил там подростком и влюбился в него. Это красиво, люди разные, сумасшедшие и удивительные, нет недостатка в развлечениях для детей, подростков и взрослых, отличная еда, великолепная погода, а районы вокруг разнообразны и великолепны, начиная с побережья Калифорнии. в горы, в секвойи, в винную страну, в Орегон на север, в Диснейленд на юг (я знаю, но у нас шестеро детей, так что.).
- Как блоггер, я могу работать в любой точке мира, и я хотел бы время от времени встречаться с друзьями и читателями, ведущими блоги в Интернете, в реальной жизни.
- Как родители, обучающиеся на дому, мы с женой хотим, чтобы у наших детей было больше возможностей учиться у окружающего их мира. Гуам — отличное место для этого, но Сан-Франциско предлагает больше. Это будет невероятный опыт для наших детей.
- Мы надеемся отказаться от автомобилей, и Сан-Франциско — подходящее место для этого: там есть муниципалитет, BART, велосипедный город, возможность ходить пешком и такие вещи, как Zipcar и City CarShare, если они нам понадобятся. Гуам — очень плохое место, чтобы ездить без машины, если у вас есть дети.
- Я веган, и Гуам тоже не подходит для этого. На Гуаме есть ровно два веганских/вегетарианских ресторана, и какими бы замечательными они ни были, я бы хотел оказаться в месте с большим выбором. Мне не терпится попробовать вегетарианские рестораны в Сан-Франциско или, по крайней мере, рестораны с большим количеством вегетарианских блюд, чем, знаете, салат . Фермерские рынки, кооперативы по производству натуральных продуктов, левые книжные магазины и тому подобное также привлекательны для таких людей, как я. Мы также рассматривали в качестве вариантов Портленд и Юджин, штат Орегон, по тем же причинам, но по сложным причинам С. Ф. наш выбор.
- У нас замечательная семья в районе залива, и мне не терпится провести с ними время. Серьезно, кроме моей семьи здесь, на Гуаме, в С.Ф. являются одними из самых роковых, которые у меня есть (ну, есть также те, что в Юджине, Остине, Вегасе, Скоттсдейле, Чикаго и паре других мест, но я отвлекся).
- Моя старшая дочь будет выпускницей средней школы в следующем учебном году, а пребывание в Калифорнии поможет ей посещать колледжи и подавать документы и даже получить вид на жительство, если она решит поступить в колледж в Калифорнии.
- Я стараюсь покупать как можно меньше, но когда мне нужно что-то купить, я предпочитаю покупать б/у. Варианты комиссионных магазинов и секонд-хендов на Гуаме, скажем так, ограничены.
Опять же, это лишь некоторые из них. Я мог бы продолжать весь день.
Я люблю Гуам, но пришло время перемен. Мы всегда вернемся на Гуам. Мы просто хотим новых впечатлений, и мы не можем ждать.
Надеюсь увидеть некоторых из вас там!
3. Какая у вас сейчас программа тренировок/бега?
На данный момент я бегаю 3-4 раза в неделю (подготовка к полумарафону), 3 раза в неделю хожу в спортзал и пару раз в неделю катаюсь на велосипеде. Вы можете увидеть мой план тренировок в этой таблице, но имейте в виду, что он меняется от месяца к месяцу в зависимости от моих целей.
Я люблю все смешивать. Я уже не так часто готовлюсь к гонкам, но по-прежнему люблю бегать. Я пытаюсь нарастить немного мышечной массы, поэтому сейчас я поднимаю тяжести, но через несколько месяцев я, вероятно, продолжу упражнения с собственным весом и тому подобное.
Прямо сейчас я езжу на велосипеде, чтобы привести себя в форму. Я надеюсь сделать его основным видом транспорта, когда перееду в Сан-Франциско.
Я также питаюсь достаточно чисто, примерно в 90% случаев. На самом деле, диета была самой большой частью моего похудения — я потерял 30 фунтов. в прошлом году на моем Bellyfat Challenge.
4. Круто. Но не могли бы вы дать нам образец того, что вы обычно едите в течение дня?
Эм, конечно. Но прежде чем я это сделаю, пара предостережений:
- Очевидно, я не ем одно и то же каждый день. Различается.
- Обычно я ем «читмил» каждую неделю, а иногда и две.
- Я не всем рекомендую свою диету — выберите стиль питания, который подходит вам, вашим целям, состоянию здоровья и т. д.
Тем не менее, вот типичный день (в последнее время):
- 7 утра 1/2 чашки приготовленных органических овсяных хлопьев с ягодами, сырым миндалем, корицей, изюмом, молотым льняным семенем.
- 10:00 Несладкая кокосовая стружка с ягодами, миндалем, соевым молоком.
- 13:00 Лебеда, овощи на пару и какой-то белок — обычно чили из черной фасоли, карри из чечевицы или вегетарианский бургер.
- 16:00 Соевый йогурт с миндалем, ягодами, некоторыми другими фруктами, молотым льняным семенем.
- 19:00 Лебеда, овощи на пару и какой-то белок — обычно чили из черной фасоли, карри из чечевицы или вегетарианский бургер.
Я не ем много злаков, кроме овсяных хлопьев (киноа — это не злак). Я веган. Я получаю более чем достаточно белка. Эта диета составляет около 400 калорий за один прием пищи или 2000 калорий в день, что дает мне дефицит в 500-1000 калорий в зависимости от физических упражнений и активности в течение дня.
Обновление : прочтите мой последний пост о моей диете здесь.
5. Во сколько вы ложитесь спать/просыпаетесь?
Этот вопрос возникает, когда я уже писал о том, как рано вставать и как рано вставать. Следует понимать, что эти сообщения были написаны в 2007 году, поэтому за последние несколько лет все изменилось.
В разное время в 2007 году я просыпался в 5:30, 5, 4:30 и 4 утра. Частично это зависело от того, где я был во время подготовки к марафону — когда я бегал на длинные дистанции, я d просыпаться в 4 утра, чтобы я мог уйти в 4:30 или 4:45 для 2 или 2,5-часовой пробежки. В те дни, когда я не занимался длительным бегом, я использовал дополнительное время рано утром, чтобы написать свой блог, прежде чем мне нужно было идти на работу.
Иногда я спал. И в эти дни я сплю половину времени, так как у меня нет дневной работы, поэтому я могу вести блог в любое время утром. Я по-прежнему встаю довольно рано много дней — обычно где-то между 5:30 и 6:30 утра — но в другие дни я сплю до 7 или даже 8 утра и позволяю своему телу восстановиться после тренировки предыдущего дня.
Когда мне идти спать? Я предпочитаю ложиться спать к 21:30 или 10 вечера, но моя жена любит посмотреть небольшой вечерний телевизор (не кабельное, а одно из наших любимых шоу на Apple TV), и я обычно не сплю с ней. до 22:30
6. Можете ли вы предоставить примерное «расписание» вашего дня?
Ух ты мальчик. Это немного сложно, так как я больше не следую установленному графику. Я предпочитаю жить момент за моментом и плыть по течению жизни. Это немного расплывчато для большинства из вас, так что вот попытка:
- 4:45 до 6:00: Просыпайтесь, выпейте кофе, почитайте. Время, когда я просыпаюсь, зависит от того, собираюсь ли я на утреннюю пробежку.
- 6:00: бег (понедельник, среда, пятница и иногда суббота)
- 7-9 или 10 утра: Пишите, выполняйте другие самые важные дела.
- с 10:00 до середины дня: мелкие задачи, чтение RSS-каналов, исследование различных вещей, которые меня интересуют (и я буду часто писать о них в блоге позже). Это действительно варьируется.
- После обеда – вечером: проведите время с детьми. Иногда тренируйся в спортзале. Или читай. Также меняется изо дня в день.
- Вечер до 22 или 22:30: поужинать, провести время с женой и детьми. Посмотрите одно из наших любимых телешоу («Офис», «Сообщество», «Как я встретил вашу маму», «Безумцы», «Остаться в живых», «Студия 30», не в таком порядке). Раз в неделю мы с Евой будем ходить на свидания.
Опять же, это грубый набросок, но в целом:
- Я выхожу на пробежку рано и делаю другие упражнения во второй половине дня.
- Далее я пишу и выполняю другие важные задачи.
- Я займусь менее важными делами позже.
- Всегда старайся находить время для Евы и детей.
7. Что случилось с функцией поиска в Zen Habits?
На новой странице «Архивы» теперь есть функция поиска, так что вы можете не только легко просматривать все старые сообщения, но и выполнять поиск по всем статьям Zen Habits с помощью Google.
8. Какую тему вы используете для Zen Habits? Доступен ли он для скачивания?
Я вручную создал тему для этого сайта. Он доступен для скачивания.
9. Какова ваша история?
Мою историю можно прочитать здесь.
10. Могу ли я использовать пост, который вы написали здесь, для моего блога, моей книги, моего журнала и т. д.?
Да, пожалуйста! Прочтите мое уведомление об авторском праве.
Нет необходимости писать мне по электронной почте для получения разрешения. У тебя уже есть мое благословение.
11. Я хочу сделать гостевой пост. В чем дело?
Я не принимаю гостевые посты.
12. Почему в названии Zen Habits есть слово «Дзен»? Вы дзен-мастер или дзен-буддист?
Нет, не я. Подробнее обо всем этом читайте здесь: Почему Zen Habits.
13. Как мне связаться с вами по электронной почте?
Я немного отшельник по электронной почте, извините, и не могу лично отвечать на электронные письма. Если у вас есть проблема или предложение, вы можете связаться с контакт на zenhabits.net .
14. Но… я хотел бы поделиться с вами своей новой книгой/публикацией в блоге/продуктом/семинаром!
Спасибо, но нет. Пожалуйста, не просите меня продвигать ваш продукт, книгу, веб-сайт, услугу или сообщение в блоге, иначе я отрежу вам каратэ.
15. Вы все еще носите Asics? Кроме того, вы пробовали бегать босиком?
Нет, я отказался от Asics.
Уже больше года я бегаю босиком и мне это нравится. Прочтите руководство, на которое я только что ссылался, прежде чем попробовать.
16. Как я могу следовать привычкам дзен? Как я могу отблагодарить вас пожертвованием? Где еще я могу прочитать ваши блестящие вещи?
Хорошо, я признаю, что это не очень распространенные вопросы, но эй, есть возможность для бесстыдной пробки (или трех), верно?
Я был бы рад, если бы вы подписались на Zen Habits по электронной почте или RSS-подписке. Это совершенно бесплатно (и так будет всегда), и вы будете получать около трех постов в неделю, все посты качественные и без лишних слов.
Если вы хотите поддержать Zen Habits, я был бы рад, если бы вы купили мою печатную книгу «Сила меньшего» или одну из моих электронных книг.
Помимо моих книг, вы можете прочитать больше о моих работах в другом моем блоге, в mnmlist, или о небольших советах и блестящих идеях в Twitter или Google+, или о ссылках, которыми я люблю делиться на tumblr Zen Habits.
Другие вопросы, которые я должен добавить в этот список? Спросите через Twitter, и я сделаю все возможное, чтобы ответить на самые распространенные из них.
Дзен обзоров кода: комментарии перед обзором
Обзоры кода могут принести большую пользу, если они сделаны хорошо и тщательно. Они делаются лучше всего, если это не является рутиной для рецензентов. Если вы сделаете их максимально простыми, объяснив предысторию правок и указав на существенные изменения, тогда процесс пойдет намного лучше для всех: Но как бы вы это сделали? Объясняет Майкл Соренс.
Введение
Создать хорошее программное обеспечение сложно, но есть много инструментов, которые вы используете каждый день, чтобы помочь вам в работе. Редактор поможет вам правильно понять синтаксис; компилятор поможет вам получить правильные ссылки; модульные тесты помогут вам правильно понять логику и так далее. Слово «правильно» подразумевает, что это абсолютное состояние, тогда как на самом деле это вопрос степени. Вы можете создать кусок едва адекватного кода или вы можете создать надежный, расширяемый, производительный фрагмент кода. Одним из очень эффективных способов улучшить качество кода является проверка вашего кода вашими товарищами по команде с помощью инструмента проверки кода, который может помочь вам интегрировать задачу в процесс разработки. Тем не менее, большинство людей не используют инструмент проверки кода правильно, потому что неправильный способ кажется более «естественным».
В этой статье объясняется, как использовать инструмент проверки кода, чтобы получать больше и лучше отзывы от рецензентов, облегчая и делая их работу менее утомительной. Техники, которые я опишу, просты, их легко освоить и легко применять: они просто не очень очевидны, пока вы их не узнаете. Как только вы сможете применить их, вы сможете заставить рецензентов вашего кода делать больше с меньшими усилиями! Я буду использовать TFS в качестве примера, но общие принципы, которые я описываю, применимы к любому инструменту проверки кода, который вы используете, или компьютерному языку, на котором вы программируете.0005
Правильный комментарий для правильной работы
С помощью инструмента проверки кода TFS вы выбираете набор файлов, которые вы хотели бы проверить: вы выбираете своих рецензентов, указываете тему, а затем добавляете один глобальный описание, содержащее любые примечания, которые вы хотите передать своим рецензентам. В этом c ode- обзоре описания вы можете печатать столько, сколько хотите, и, безусловно, полезно дать высокоуровневый контекст вашим изменениям. Вы ограничены в том, что вы можете или должны добавить в общий глобальный комментарий, прикрепленный к вашему код-ревью. Оно должно быть широким по объему, но кратким и по существу; задает тон всему, что последует.
Однако этого описания проверки кода недостаточно для эффективной проверки: вы также должны указать детали: «Но это же просто», — возражаете вы. «Просто добавьте комментарии в код для всего, что может показаться сложным или неясным». Эти комментариев в коде , опять же, безусловно, очень полезны, но все же недостаточны. Комментарии в коде отлично подходят для объяснения того, что такое , но последний тип комментариев — то, что я называю предварительными комментариями -объяснить что изменилось , что, возможно, является наиболее важным аспектом проверки кода.
Тип | Детали | Когда использовать |
Комментарии в коде | Аннотируйте существующий код, чтобы объяснить неясный или сложный код. | До создание обзора кода |
Код-ревью Описание | Отдельный общий комментарий, прикрепленный к обзору кода при его создании. | При создании обзора кода, указанном вместе с рецензентами |
Предварительные комментарии | Объясните неочевидные изменения предыдущей версии в текущей версии. | После создания обзора кода, но до отправки рецензентам |
Вы уже знаете, как добавить два из этих типов: комментарии в коде и описание обзора кода. Менее очевидно, как добавлять комментарии третьего типа, предварительные комментарии, в TFS: это не кажется естественным, поэтому разработчику не приходит в голову их использовать. Для него нет ни кнопки, ни поля, ни элемента управления; это просто процесс, и притом простой:
- Назначьте себя единственным рецензентом.
- Отправить отзыв- себе .
- Откройте обзор, просмотрите каждое изменение и добавьте комментарии, объясняющие, что вы сделали.
- Отправьте свои заполненные комментарии- себе .
- Добавить других рецензентов.
То есть первое, что вы делаете, это меняете шляпу разработчика на шляпу рецензента. Однако, в отличие от ваших предполагаемых рецензентов, которые изучат все ваши изменения и зададут вопросы , ваша задача состоит в том, чтобы изучить все ваши вопросы и дать ответы : другими словами, аннотировать код, чтобы объяснить , почему были внесены существенные изменения. Процесс отправки заполненных комментариев самому себе (шаг D) фактически публикует или встраивает ваши комментарии в код-ревью. Когда вы затем добавляете дополнительных рецензентов (шаг E), они получают изменения кода вместе с вашими комментариями.
Предварительные комментарии так же ценны для рецензента с кодом , как комментарии в коде для считывателя кода (первый заинтересован в изменениях кода, а второй — в содержании кода). Рецензент кода является надмножеством читателя кода, поэтому можно получить представление о как комментариев в коде, так и комментариев перед просмотром. Однако они достаточно различны. Комментарии в коде описывают что присутствует , тогда как комментарии перед просмотром описывают почему он изменился .
Почему это важно? Работа рецензента состоит в том, чтобы дать полезную обратную связь, а это означает, что рецензент должен понять проблему, которую решает ваша проверка кода, затем просмотреть ваши изменения (независимо от того, действительно ли они относятся к рассматриваемой проблеме или нет) и, наконец, выяснить, что вы изменения означают в контексте , то есть последствия этих изменений. Как автор, у вас есть несправедливое преимущество. Вы уже знаете проблему, которую решает ваш код. Вы знаете, какие изменения существенны, а какие просто шум. Y ou знают большинство (а иногда и все) последствия ваших изменений: Так почему бы не поделиться этой ценной информацией со своими рецензентами кода? Делитесь всем, используя комментарии перед рецензированием, поэтому вашим рецензентам больше не нужно сначала узнавать, как добраться до точки, с которой вы начали, а затем от того, с чего вы начали, до того, где вы закончили.
Пример #1
Представьте, что вы работаете над веб-проектом, и внесите следующее изменение CSS:
Оригинал | поле : 8px |
Пересмотренный | поля: 15px 8px 8px 0 |
Что ты видишь прямо перед собой? Ответ на этот вопрос не так очевиден, как может показаться. Я полагаю, что ответ будет «. Это зависит от ». Вы веб-разработчик? Если нет, возможно, вы все же немного познакомились с CSS; или, возможно, вы даже не знаете, что означает аббревиатура CSS. Даже если вы это веб-разработчик, возможно вы работаете с CSS, а может и нет. Если вы знаете CSS, насколько вы опытны? Знаете ли вы разницу между свойством margin с одним параметром и свойством margin с четырьмя параметрами? Даже если вы знаете, для чего используется четырехпараметрическое свойство margin , знаете ли вы порядок параметров?
То, что вы видите выше, может быть чем угодно: от «строки текста» до «изменения верхнего и левого полей для определенного класса CSS». Давайте поместим это в более целенаправленный контекст. Предположим, вы внесли указанные выше изменения и отправили их на проверку кода. Как правило, процесс отправки обзора кода включает в себя, что вполне естественно, отправку ваших изменений кода.0048 и ничего больше . То есть рецензент увидит именно это:
Оригинал | поле : 8px |
Пересмотренный | поля: 15px 8px 8px 0 |
Но учтите:
- Даже если ваши рецензенты являются разработчиками, они могут не знать, что означает этот «маржа».
- Даже если веб-разработчики, если они не видели страницу, они бы не поняли, какое поле вы меняете.
- Даже если они знакомы с веб-страницей и поля, они могут не понять, почему . Почему эти цифры? Почему это изменение решает проблему? Если уж на то пошло, , в чем проблема ?
Чтобы облегчить задачу рецензенту, пометьте изменение комментарием, содержащим как контекст, так и обоснование изменения. Например:
Оригинал | поля: 8px |
Пересмотренный | поля: 15px 8px 8px 0 |
«Раньше вокруг формы поиска была равномерная 8-пиксельная рамка. Пересмотрено: верхняя граница увеличена до 15 для лучшего визуального отделения от текста выше, а устранено , полностью оставило поле , чтобы теперь оно выравнивалось с другими элементами на странице».
Таким образом, без необходимости быть знакомым со страницей и без даже веб-разработчика, рецензент может дать полезный отзыв об этом изменении !
Теперь вы можете возразить, что можете сделать тот же самый комментарий, что и комментарий в коде, возможно, сформулированный так (просто удалив все временные и сравнительные ссылки из приведенной выше версии):
«Установить верхнюю границу до 15 для визуального отделения от текста выше и полностью убрать левое поле, чтобы оно совпадало с другими элементами на странице».
В этом примере вы получаете практически такое же воздействие; следующий пример показывает, что это не всегда так.
Пример #2
Допустим, вы работаете над проектом PowerShell и исправляете эту ошибку.
Оригинал | Set-Version $environment $package Если ($result.Success) { … |
Пересмотренный | $result = Set-Version $environment $package Если ($result. Success) { … |
Ваши рецензенты, вероятно, могли бы догадаться, что там произошло, но им это не нужно! Как автор изменения, вы уже точно знаете, что изменилось и почему — так что просто укажите это. Вот одна из возможных версий комментария перед проверкой:
«Исправление ошибки: выходные данные командлета не записывались, поэтому они отправлялись в конвейер; вот почему выходной поток показал пустая строка, указанная в отчете о дефекте. Но я нашел еще более коварно (и не в отчете о дефекте!), следующая строка была тогда действующей об успехе/неуспехе предшествующей операции, а не действующей текущий !”
В отличие от предыдущего примера, здесь , а не поддается эквивалентному комментарию в коде. На самом деле, ни один из этого утверждения не подходит для встраивания в сам код; это имеет смысл только в контексте проверки кода в качестве комментария перед проверкой.
Комментарии перед рецензированием Увеличивают отношение сигнал/шум для рецензентов
Помимо предоставления важной информации о конкретной строке кода, компоненте или архитектурной проблеме, комментарии до рецензирования касаются еще одного важного аспекта проверки кода, который может значительно улучшить опыт ваших рецензентов: отношение сигнал/шум.
Соотношение сигнал-шум сравнивает уровень полезного сигнала с уровнем фонового шума (Википедия). В контексте проверки кода 9Сигнал 0048 — это набор изменений, отвечающих цели проверки кода. шум — это набор случайных изменений, которые вы внесли по целому ряду других законных причин: возможно, потому, что вы уже касались файла, или потому, что вы думали, что такие косметические корректировки облегчат отслеживание ваших реальных изменений. В качестве альтернативы, это могло просто сделать код более аккуратным или могло произойти из-за того, что ваш текстовый редактор автоматически переформатировал код для вас. Такие изменения могут включать: корректировку отступа, добавление или удаление пустых строк, изменение имени метода, чтобы сделать его более строгим, изменение регистра имени переменной или множество других изменений рефакторинга (например, введение или удаление переменной из метода). , исключая магические строки/числа и т. д.).
Рассмотрим, например, этот единственный файл, открытый из обзора кода TFS:
Этот файл показывает довольно много изменений (согласно столбцам различий справа)… но в данном случае это почти чистый шум!
Изменения в верхней половине — это просто автоматическое форматирование (пробелы), автоматически выполняемое текстовым редактором. Изменения в нижней половине — это всего лишь несколько функций, которые были перемещены в новый класс.
Вы заметили, что я только что вставил: два только что объясненных предложения ровно что передать вашим рецензентам. Это сокращает время просмотра этого файла до времени, необходимого для чтения этих двух предложений.
Теперь давайте сделаем шаг назад и посмотрим на полный список файлов в обзоре примера кода из панели TFS Team Explorer, показанной справа. Этот обзор кода включает множество файлов с изменениями. Многие из них здесь, возможно, 75%, присутствуют только потому, что один класс был перемещен или переименован, поэтому единственное изменение — это просто оператор использования в начале файла.
Но подумайте о своей аудитории. После просмотра десяти или около того таких файлов вы действительно думаете, что они будут усердно просматривать каждый из них? Вы не только выиграете от более тщательного обзора, но и ваша работа — помочь им, уменьшив шум. Одно из возможных решений: для (скажем) шести значимых файлов добавить комментарий «Соответствующие изменения в этом файле». Неявно вы говорите, что только те файлы, которые были отмечены таким образом, нуждаются в тщательном просмотре, но все остальные, которые были затронуты, также включены, если вы хотите также кратко их просмотреть.
Поскольку комментарии, добавленные в TFS, отображаются непосредственно на панели Team Explorer, можно быстро и легко выбрать и просмотреть только эти важные изменения.
Ценность проверки собственного кода
Чтобы подготовить предварительные комментарии, вам нужно просмотреть свой код и тщательно просмотреть изменения строка за строкой… другими словами, делать именно то, что вы хотите, чтобы ваши рецензенты делали! Конечно, однако, это то, что вы должны сделать в любом случае? Хотя цель код-ревью, конечно, состоит в том, чтобы иметь другие пар глаз просматривают вашу работу, вы будете удивлены тем, насколько эффективным может быть обмен ролями и смена шляпы разработчика на шляпу рецензента. Вот лишь пара примеров.
- Как рецензент, вы, скорее всего, возьмете список файлов, представленный TFS, и пройдетесь по ним один за другим, изменение за изменением. Маловероятно, что вы писали код в одном и том же порядке, так что это уже вынуждает вас иметь другую точку зрения.
- Когда вы в последний раз смотрели на изменения, которые вы вызвали в . слн или . csproj файлы как разработчик? Гораздо более вероятно, что вы сделали это как рецензент. (Ну, пожалуй 🙂 Нередко Visual Studio вносит изменения в те файлы, которые не нужны для вашего конкретного проекта и они, по сути, нуждаются в вашей проверке. настройки файла . csproj в соответствии с соглашениями вашей компании, и важно проверить, чтобы убедиться, что они не были упущены.0038
- Вы когда-нибудь оставляли часть кода не совсем законченной, намереваясь вернуться к ней перед тем, как отправить свою работу на проверку, но забывали это сделать? Выполнение собственного обзора кода при подготовке комментариев к предварительному обзору почти гарантирует, что вы обнаружите эти типы ошибок.
Общие и целевые комментарии
Для начала приведу несколько общих примеров из моего списка предварительных комментариев:
- Из предыдущего обзора кода
- Игнорировать это изменение
- Добавлен в тихий ReSharper
- Не относится к этому обзору кода
- Соответствующие изменения в этом файле
- В этом суть проблемы
- Область удаленного текста перемещена в…
- Описание взято из требований к выпуску.
…и эти примеры более целенаправленны …
- Подсказка перемещена, чтобы охватить весь заголовок, а не только его фразу
- Исправлено несоответствие между названием теста и тем, что тестируется
- Не очень довольны всеми именами методов в этом классе; если у вас есть идеи, дайте мне знать!
- Не знаю, насколько это издает запах кода, но свою работу выполняет.
- Единственным существенным изменением для этой проверки кода является добавление . отделка( ) к этим 2 строчкам.
Заключение
Хороший разработчик, работающий в команде, максимально упрощает проверку кода для рецензентов. С небольшими усилиями, приложенными к проверкам кода, вы можете значительно продвинуться к получению более качественных отзывов о проверках кода. Например, просто укажите несколько ключевых файлов или несколько ключевых строк, на которых должен сосредоточиться рецензент.