Skip to content

Commit f64a51b

Browse files
committed
Response to KT's review
1 parent f56a2b8 commit f64a51b

File tree

1 file changed

+12
-11
lines changed

1 file changed

+12
-11
lines changed

communications/slack-culture.rst

+12-11
Original file line numberDiff line numberDiff line change
@@ -88,25 +88,25 @@ You can save space, time, and distractions to others by using commonly understoo
8888
Direct messages
8989
---------------
9090

91-
Please keep direct messaging to a user or a set of users to minimum.
91+
Please keep direct messaging to a user or a set of users to a minimum.
9292
Direct messages should be avoided for any technical discussions or asking for support, even if you are sure that you have involved all those who are interested or who can contribute.
93-
Instead, such discussions should be in a thread in an appropriate :ref:`discussion channel<slack-discussion-channels>`.
94-
Direct messages shoul be reserved for conversations on topics such as code review requests, logistics, or on other topics not directly related to work.
93+
Instead, such discussions should be in a thread in an appropriate :ref:`discussion channel<slack-discussion-channels>` and support questions must be asked in an appropriate :ref:`support channel<slack-support-channels>`.
94+
Direct messages should be reserved for conversations on topics such as code review requests, logistics, or on other topics not directly related to work.
9595
See this `community post`_ for why direct messages are considered harmful.
9696

9797
.. _community post: https://community.lsst.org/t/dms-in-slack-considered-harmful/4036
9898

9999
.. _slack-editing:
100100

101-
Editing messages
102-
----------------
101+
Editing and deleting messages
102+
-----------------------------
103103

104104
Slack has a feature that allows a user to edit a message sent by that user.
105-
This feature must be used for typographical or grammatical errors that the user wishes to correct, or if the message is accidentally sent before it is fully typed out.
106-
While Slack is less formal than email, messages should be coherent and in multiple sentences if required, instead of multiple single-line messages in short bursts. This is so that it is easy to link to them elsewhere in the future.
107-
In place of amending a message, it is preferable to use strikethrough to retract an idea or statement that If you post something you recognize as wrong.
108-
A corrected statement can be added next to it.
109-
A message should be deleted only if posted in a wrong channel, or if it is not appropriate in a social forum.
105+
106+
- This edit feature is ideal to correct typographical or grammatical errors, or if the message is accidentally sent before it is fully typed out.
107+
- In order to easily link them elsewhere, messages should be coherent and in multiple sentences if required, instead of multiple single-line messages in short bursts.
108+
- In place of amending a message, it is preferable to use strikethrough ``~text~`` to retract an idea or statement that if you post something you recognize as wrong. A corrected statement can be added next to it. This prevents surprises of seeing a notification and not finding that message on Slack. Moreover, this indicates the thought process undergone and avoids somebody else posting the same point again.
109+
- A message should be deleted only if posted in a wrong channel, or if it is not appropriate in a social forum.
110110

111111
.. _slack-snippets:
112112

@@ -217,7 +217,8 @@ If you need to have a group created because you have a routine need to @-mention
217217
@-mentioning a particular user notifies that user and adds the message to their "Mentions & reactions" list.
218218
Be aware of the person's timezone before @-mentioning them.
219219
If you need to @-mention them outside normal hours, you may want to schedule the message to be posted later (using the ``/send`` or more sophisticated ``/schedule`` shortcuts from `Timy`_).
220-
Sometimes @-mentioning a user can be helpful to disambiguate replies in a multi-person conversation, but if you find yourself prefixing every message you send with an @-mention, consider whether it is implied by context or whether the whole conversation might be better in a thread.
220+
Sometimes @-mentioning a user can be helpful to disambiguate replies in a multi-person conversation, but if you find yourself prefixing every message you send with an @-mention, consider whether it is implied by context or whether the whole conversation might be better in a thread or in direct messages to that user if the issue at hand is unique to the user.
221+
An example where it is acceptable to move to direct messaging would be to help out unexpected login issues faced by the user.
221222

222223
.. _Timy: https://timy.website/#commands
223224

0 commit comments

Comments
 (0)