Hacker News new | past | comments | ask | show | jobs | submit
Lush, the bathbombs company, has an internal tech team that builds the apps, website, and point of sale systems. I worked there for a little while on some web-based tooling for payments which involved working with the Japanese team who did the tech for the Japanese site. They were really good. Everything was incredibly clear and easy to understand because they had to put a lot of effort into written comms due to both the language barrier and the time difference. I built a great appreciation for what concise, high quality communication looks like.

It's worth getting a role where you're forced into improving. I'm definitely a better communicator than I was before that job because of it.

I have a similar experience. Whenever I send message to my Japanese colleagues their response is always detailed and precise. They might take time in replying as of course they use AI and auto translating tools but the reply will be accurate. In fact, I find the worse level of English understanding the better the answer they provide, and it’s not only the work they put into it, there is a feeling of respect and importance towards other people work which I really appreciate.
Sounds really nice! Do you have an example of the concise, high quality communciation the Japanese team used? It'd be interesing to see what they focused on to make it so clear.
There are a few things.

- They didn't make assumptions about what the person reading would already know. Everything simple was explained, and was there were link to prior docs where complicated concepts were needed (e.g end of day cash consolidation in a store, because Japanese stores worked differently to US and Europe.) That made it really easy to read any document in isolation. We had a really good wiki that covered everything.

- The team insisted on keeping docs up to date, and deprecating old docs for things that weren't relevant any more. They kept things tidy. They didn't drop writing documentation when things got busy.

- They seemed to have spent quite a lot of effort organising things - tickets were always labelled and complete.

- They were dedicated to using consistent terminology everywhere. They had a glossary and they stuck to it, and that extended to the code that they wrote. Product docs, tech docs, and code all used the same language for the same thing. I think they avoided using similar terms for things too, especially where things could be ambiguous in translation from Japanese to English and vice versa.

To be honest, and with a decent amount of hindsight, I don't think anything was especially clever. It was just clear that the team put the effort in to doing the things most teams know they should be doing. I haven't worked there for a few years now but I bet they're having a lot of success with AI because that documentation would be a great source of context.

loading story #47287119
loading story #47289119
loading story #47286428