Re:Support for team members who are mistreated in their country
by foxpurple on Tuesday July 20, 2021 @08:25PM
(#27900892)
I’d argue that seeing 1. 1. 1. Is actually better than seeing them increasing but being out of order. Less of a hack and while reading them unformatted you just think of it like a HTML OL with list items. Or of the 1 as a keyword meaning ordered list item.
[ Parent
| on HN ]
Re:Support for team members who are mistreated in their country
by paxys on Tuesday July 20, 2021 @08:27PM
(#27900908)
Needlessly numbering lists when bullets would serve the purpose is one of my pet peeves.
Re:Support for team members who are mistreated in their country
by lbotos on Tuesday July 20, 2021 @08:38PM
(#27900973)
Culturally at GitLab we use numbered lists so that it makes it easy to link and reference someone to a spot on the page.
see https://about.gitlab.com/handbook/communication/#writing-sty... number 13:
If you have multiple points in a comment or email, please number them. Numbered lists are easier to reference during a discussion over bulleted lists.
Re:Support for team members who are mistreated in their country
by po on Tuesday July 20, 2021 @09:24PM
(#27901247)
Interesting. With editable docs, things sometimes get added above the points or reordered and then re-numbered which makes the discussion misleading. The reason I prefer bullets is that it encourages people to quote the relevant section when discussing.
Re:Support for team members who are mistreated in their country
by airstrike on Tuesday July 20, 2021 @10:43PM
(#27901788)
Is #28 mixing up sending and receiving?
>28. If an email needs a response, write the answer at the top of it.
Alternatively, it feels like it could read:
> If an email includes a response, place it at the top of it. If an e-mail requires a response, also make that clear at the very top.
Re:Support for team members who are mistreated in their country
by randallsquared on Tuesday July 20, 2021 @10:48PM
(#27901815)
The judgement about whether an email needs a response is left to the receiver who would be responding, in their statement. I like that mental model of things. :)
Re:Support for team members who are mistreated in their country
by airstrike on Wednesday July 21, 2021 @11:32AM
(#27907655)
That leaves room for miscommunication, though. If someone expects a response from me, I'd rather they make sure to ask it at the very top so that I don't miss that request with everything else that's going on.
Re-reading the statement, maybe they simply mean replies should be above the original e-mail rather than inline?
Re:Support for team members who are mistreated in their country
by randallsquared on Wednesday July 21, 2021 @08:42PM
(#27914012)
I believe that's what they intended to convey, yes.