[cfors]

Unfortunately Slack is where documentation goes to die. When I face a weird internal issue the first thing I do is search:

> in:@<channel> <error>

You would be amazed at how much unofficially documented stuff is sitting in Slack. It is unfortunate but paying attention to the right Slack channels at work can be very important in understanding company strategies and decision making, as well as random tidbits on architecture decisions.

Of course I would prefer official documentation but sometimes you gotta make do.

[xenadu02]

The alternative in most cases is _no documentation at all_. It's not like people would go spend two hours writing up documentation if Slack didn't exist.

[tim58]

In large teams it's worth the reduction in 'code velocity' to have engineers document what they are building.

I specifically make efforts, and encourage others to do the same, to keep most documentation outside of slack. Do you have a question about a ticket? Ask it in a comment not slack. Do you have a question about how our system works? Ask it in the private Stack Overflow. Want to advertise a cool new internal service we can use? Great tell everyone in slack, but also add it to swaggerhub.