-
Notifications
You must be signed in to change notification settings - Fork 0
proposal/process-review-no-code-managment-tasks common: added info #72
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you! Great!
doc/common/README.md
Outdated
Например: | ||
[Документ GoogleDocs](https://docs.google.com/spreadsheets/d/1yZT4qOec28r-uTDg9uz3TOvNi5I0ePbppZa7URWby1s/edit?usp=sharing) | ||
|
||
2. После того, как ревьюер завершил фиксирование замечаний, он уведомляет об этом автора задач. |
There was a problem hiding this comment.
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: Переводит задачу в статус "открыта" / "переоткрыта", чтобы другие ревьюеры делали обзоры на непросмотренные задачи.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done
doc/common/README.md
Outdated
|
||
Такие задачи, как документирование в Notion, Confluence и пр. | ||
|
||
1. Ревьюер в процессе обзора кода фиксирует свои замечания и пожелания в одном |
There was a problem hiding this comment.
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 "ревьюер".
There was a problem hiding this comment.
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!!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done
doc/common/README.md
Outdated
4. После того, как автор задачи завершил улучшение проделанной работы и отметил все пункты как | ||
завершённые, он также сообщает об этом ревьюверу. | ||
|
||
5. Если ревьювер с чем-то не согласен, он отмечает незавершённые пункты и отдаёт их на доработку, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
5. Если ревьювер с чем-то не согласен, он отмечает незавершённые пункты и отдаёт их на доработку, | |
5. Если ревьюер с чем-то не согласен, то процесс повторяется с шага 2, иначе задача переводится в состояние "готово". |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done
doc/common/README.md
Outdated
месте. \ | ||
Например: | ||
[Документ GoogleDocs](https://docs.google.com/spreadsheets/d/1yZT4qOec28r-uTDg9uz3TOvNi5I0ePbppZa7URWby1s/edit?usp=sharing) | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
В данном случае мы также преследуем цель: сократить количество отвлекающих воздействий на автора изменений, чтобы меньше отвлекать друг друга от работы. В данном случае должно остаться всего одно воздействие в виде ссылки на страницу с комментариями. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done
doc/common/README.md
Outdated
1. Ревьюер в процессе обзора кода фиксирует свои замечания и пожелания в одном | ||
месте. \ | ||
Например: | ||
[Документ GoogleDocs](https://docs.google.com/spreadsheets/d/1yZT4qOec28r-uTDg9uz3TOvNi5I0ePbppZa7URWby1s/edit?usp=sharing) |
There was a problem hiding this comment.
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:
- Comments to task in review channel. One comment - one message as we did before. Then author of changes mark each item with green checkmark.
- Find special app for slack with checkboxes if we want checkboxes :)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you!! Splendid!
doc/common/README.md
Outdated
затягивается и ревью. | ||
|
||
#### 6.4.4. Противоречия и споры в процессе обзора кода | ||
#### 6.4.4. Процесс обзора задачи, не связанных с системой управления кодом (Github, Gitlab) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
#### 6.4.4. Процесс обзора задачи, не связанных с системой управления кодом (Github, Gitlab) | |
#### 6.4.4. Процесс обзора задач, не связанных с системой управления кодом (Github, Gitlab) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
done
doc/common/README.md
Outdated
|
||
1. Рецензент в процессе обзора кода фиксирует свои замечания и пожелания в одном | ||
месте. \ | ||
Например: тематический канал в Slack, с отключёнными уведомлениями. \ |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Например: тематический канал в 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)
doc/common/README.md
Outdated
Такие задачи, как документирование в Notion, Confluence и пр. | ||
|
||
Мотивация:\ | ||
Сократить количество отвлекающих воздействий на автора изменений до 2 (в позитивном сценарии), |
There was a problem hiding this comment.
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.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
doc/common/README.md
Outdated
А также переводит задачу в статус «открыта» / «переоткрыта», чтобы другие рецензенты делали | ||
обзоры только на непросмотренные задачи. | ||
|
||
3. Автор задачи знакомится со списком замечаний и пожеланий, называет список вопросов и обсуждает |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
3. Автор задачи знакомится со списком замечаний и пожеланий, называет список вопросов и обсуждает | |
3. Автор задачи знакомится со списком замечаний и пожеланий, формирует список вопросов и обсуждает |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done
doc/common/README.md
Outdated
4. Автор задачи отмечает сделанные задачи смайлом: ✔ | ||
|
||
5. После того, как автор задачи завершил улучшение проделанной работы и отметил все пункты как | ||
завершённые, он также сообщает об этом рецензенту. |
There was a problem hiding this comment.
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.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done
… to tree quotes; updated rules
# Conflicts: # doc/common/README.md
No description provided.