[rvalue]

Intellij does a very good job for most of my programming and I use it daily.

In the process of learning a distributed system, the process of looking at the code as its documentation is not the ideal way. One could spend enormous amount of time to just understand a simple business usecase.

But then just because it takes time doesn't make it untrue.

I would rather accept a system which self documents itself with every change.

The point of breaking things is all well and good but to truly understand everything, after breaking also one needs to put the together one by one and understand their interactions so that if any one in the pool of modules fails, one knows what exactly would have caused it and how to be more resilient towards failures.

[joeevans1000]

What do you use in IntelliJ to self document? I have a hard time reviewing code effectively, so I'm curious about your strategies there.

[rvalue]

I think there is some confusion here.

What i meant was applications should be self documenting, something like swagger comes to my mind.