Skip to content

Conversation

Danilqa
Copy link
Contributor

@Danilqa Danilqa commented Sep 5, 2019

No description provided.

@Danilqa Danilqa self-assigned this Sep 5, 2019
Copy link
Contributor

@tohasan tohasan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you! Great!

Например:
[Документ GoogleDocs](https://docs.google.com/spreadsheets/d/1yZT4qOec28r-uTDg9uz3TOvNi5I0ePbppZa7URWby1s/edit?usp=sharing)

2. После того, как ревьюер завершил фиксирование замечаний, он уведомляет об этом автора задач.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suggest to add also: Переводит задачу в статус "открыта" / "переоткрыта", чтобы другие ревьюеры делали обзоры на непросмотренные задачи.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done


Такие задачи, как документирование в Notion, Confluence и пр.

1. Ревьюер в процессе обзора кода фиксирует свои замечания и пожелания в одном
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suggest to use russian word in russian text. For instance, we can use either "рецензент" or "автор обзора" instead of "ревьюер".

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wow, a really great term, thanks!!

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

4. После того, как автор задачи завершил улучшение проделанной работы и отметил все пункты как
завершённые, он также сообщает об этом ревьюверу.

5. Если ревьювер с чем-то не согласен, он отмечает незавершённые пункты и отдаёт их на доработку,
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
5. Если ревьювер с чем-то не согласен, он отмечает незавершённые пункты и отдаёт их на доработку,
5. Если ревьюер с чем-то не согласен, то процесс повторяется с шага 2, иначе задача переводится в состояние "готово".

Copy link
Contributor Author

@Danilqa Danilqa Sep 8, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

месте. \
Например:
[Документ GoogleDocs](https://docs.google.com/spreadsheets/d/1yZT4qOec28r-uTDg9uz3TOvNi5I0ePbppZa7URWby1s/edit?usp=sharing)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
В данном случае мы также преследуем цель: сократить количество отвлекающих воздействий на автора изменений, чтобы меньше отвлекать друг друга от работы. В данном случае должно остаться всего одно воздействие в виде ссылки на страницу с комментариями.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

1. Ревьюер в процессе обзора кода фиксирует свои замечания и пожелания в одном
месте. \
Например:
[Документ GoogleDocs](https://docs.google.com/spreadsheets/d/1yZT4qOec28r-uTDg9uz3TOvNi5I0ePbppZa7URWby1s/edit?usp=sharing)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We also can use slack one of the following ways:

  1. Comments to task in review channel. One comment - one message as we did before. Then author of changes mark each item with green checkmark.
  2. Find special app for slack with checkboxes if we want checkboxes :)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

@Danilqa Danilqa requested a review from tohasan September 8, 2019 14:55
Copy link
Contributor

@tohasan tohasan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you!! Splendid!

затягивается и ревью.

#### 6.4.4. Противоречия и споры в процессе обзора кода
#### 6.4.4. Процесс обзора задачи, не связанных с системой управления кодом (Github, Gitlab)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
#### 6.4.4. Процесс обзора задачи, не связанных с системой управления кодом (Github, Gitlab)
#### 6.4.4. Процесс обзора задач, не связанных с системой управления кодом (Github, Gitlab)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done


1. Рецензент в процессе обзора кода фиксирует свои замечания и пожелания в одном
месте. \
Например: тематический канал в Slack, с отключёнными уведомлениями. \
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Например: тематический канал в Slack, с отключёнными уведомлениями. \
Например: канал `review` в Slack, где уже есть ссылка на задачу от автора изменений. \
Соответственно он получит уведомление об оставленном комментарии.

It is a little bit contradict with origin idea, but there is no problem if we activate special mode that described in comment above.

The bonuses:

  • there is no additional channel
  • we guard ourselves not only from review messages, but also from any other
  • we can use telegram for some exceptional cases (it should be very rare case)

Такие задачи, как документирование в Notion, Confluence и пр.

Мотивация:\
Сократить количество отвлекающих воздействий на автора изменений до 2 (в позитивном сценарии),
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can solve it using mode Not Disturb Me (https://get.slack.help/hc/en-us/articles/214908388-Pause-notifications-with-Do-Not-Disturb) in Slack with specified schedule. We can create special rule for our team so that we have only a few time windows when we check out new messages and send responses.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

#81

А также переводит задачу в статус «открыта» / «переоткрыта», чтобы другие рецензенты делали
обзоры только на непросмотренные задачи.

3. Автор задачи знакомится со списком замечаний и пожеланий, называет список вопросов и обсуждает
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
3. Автор задачи знакомится со списком замечаний и пожеланий, называет список вопросов и обсуждает
3. Автор задачи знакомится со списком замечаний и пожеланий, формирует список вопросов и обсуждает

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

4. Автор задачи отмечает сделанные задачи смайлом: ✔

5. После того, как автор задачи завершил улучшение проделанной работы и отметил все пункты как
завершённые, он также сообщает об этом рецензенту.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suggest to not use indent for all lines of list item because it is difficult to maintain it. See list item below.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

@Danilqa Danilqa requested a review from tohasan September 9, 2019 08:26
@tohasan tohasan merged commit d22e0df into dev Sep 12, 2019
@tohasan tohasan deleted the proposal/review-process-no-code-tasks branch September 12, 2019 17:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants