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.
Getting small details right is something everyone thinks is obvious. But how to achieve it without becoming mired in processes and keeping work going is a skill that is very difficult to cultivate and a very difficult problem to solve. Requiring a lot of clever people skills. Warms my heart to hear stuff like this.
This reminds me a lot of my recent trip to Japan. The country isn't such a delight to be in for anything special, it's just clear that _they put the effort in to doing the things most people know they should be doing_. It's this discipline?