[sandGorgon]

>Having remote coworkers allows us to engage more thoughtfully with each other, and often pushes us to write more (and more useful) documentation so that we _aren't_ expecting immediate answers from any specific human.

this is very interesting - is this emergent behavior or have you guys figured out some todos that makes this an effective tool ? for example, do you consciously allocate more time for documentation by developers, than you did before remote workers ? is there a particular way you do this that makes it better, etc ?

[brechin]

This is my experience at the company I'm currently at which has offices in SF and other US locations, as well as a significant number (as a % of the Eng team) of remote people across the country. I don't know the origin story, as the practice was in place when I joined this team, but it's proven its value time and time again. We do consciously make time to document and discuss how to make that information more useful/discoverable/accurate.

* Use the tools - ticket tracking, chat rooms, wikis or other documentation repositories

* Own it - engage in the conversation, do the work, help the whole team get better, accept responsibility, acknowledge your own mistakes, and acknowledge others' wins and contributions

* Do it in public - @mention people in tickets, etc., use PUBLIC chat spaces, use org-wide sharing of documents

A company I worked for in the past, which had a SF office and a smaller number of remote engineers, did not embrace the value of thoughtful written communication, and ultimately didn't see the value of remote engineers. It fostered a culture of "need-to-know" conversations where they felt if you couldn't be "in the room" then you simply weren't going to have the information you needed. They didn't value recording (video, text, etc.) the agenda, discussion, or outcomes of these discussions, so it only lived on in the individuals involved. This artificially stunted the remote engineers, and in turn it backfired on the entire team's productivity.

[CodeCube]

In my experience, this has been both an emergent behavior that has worked out well, and subsequently a culture/process that has been encouraged by management for new members (both remote and in-office) of the team.

There hasn't necessarily been a need to allocate more time for documentation, except for everyone getting in the habit of default communication modes being easily accessible documentation (common wiki/docs that all decisions, specs, and proposals go into) ... so it's not a "more time" thing, as much as it's a "don't send an email, but instead update the docs"